query · Module: Trade · Requires trade:read
Arguments
| Argument | Type | Description |
|---|---|---|
createdGte | Int | Filter by created gte. |
createdLte | Int | Filter by created lte. |
limit | Int | Page size, 1–100 (default 10). |
startingAfter | ID | Cursor: return objects after this ID. |
endingBefore | ID | Cursor: return objects before this ID. |
Returns
LandedCostList!
| Field | Type |
|---|---|
data | [LandedCost!]! |
has_more | Boolean |
Errors
Errors are returned inerrors[], with the REST error object in extensions (type, code, param, request_id), using the codes in Conventions §9.
query LandedCosts($limit: Int) {
landedCosts(limit: $limit) {
data {
id
object
livemode
created
updated
expires_at
guaranteed
currency
incoterm
regime {
type
threshold {
amount
currency
}
collected_at
}
de_minimis {
duty {
amount
currency
}
tax {
amount
currency
}
duty_applied
tax_applied
}
items {
index
import_hs_code
customs_value {
amount
currency
}
duties {
name
kind
rate
basis
}
taxes {
name
kind
rate
basis
}
}
fees {
name
kind
option
amount {
amount
currency
}
carrier_code
}
totals {
duties {
amount
currency
}
taxes {
amount
currency
}
fees {
amount
currency
}
total {
amount
currency
}
}
messages {
code
level
message
param
carrier
}
}
has_more
}
}
{
"limit": 10
}
{
"data": {
"landedCosts": {
"data": [
{
"id": "lc_1a2B3c",
"object": "landed_cost",
"livemode": true,
"created": 1791302400,
"updated": 1791302400,
"expires_at": 1791302400,
"guaranteed": true,
"currency": "usd",
"incoterm": "example",
"regime": {
"type": "standard",
"threshold": {
"amount": 1299,
"currency": "usd"
},
"collected_at": "point_of_sale"
},
"de_minimis": {
"duty": {
"amount": 1299,
"currency": "usd"
},
"tax": {
"amount": 1299,
"currency": "usd"
},
"duty_applied": true,
"tax_applied": true
},
"items": [
{
"index": 2,
"import_hs_code": "GB",
"customs_value": {
"amount": 1299,
"currency": "usd"
},
"duties": [
{
"name": "Example",
"kind": "example",
"rate": 0.145,
"basis": "example"
}
],
"taxes": [
{
"name": "Example",
"kind": "example",
"rate": 0.145,
"basis": "example"
}
]
}
],
"fees": [
{
"name": "Example",
"kind": "base",
"option": "example",
"amount": {
"amount": 1299,
"currency": "usd"
},
"carrier_code": "EXPRESS_WORLDWIDE"
}
],
"totals": {
"duties": {
"amount": 1299,
"currency": "usd"
},
"taxes": {
"amount": 1299,
"currency": "usd"
},
"fees": {
"amount": 1299,
"currency": "usd"
},
"total": {
"amount": 1299,
"currency": "usd"
}
},
"messages": [
{
"code": "dhl_express_worldwide",
"level": "info",
"message": "example",
"param": "example",
"carrier": "dhl_express"
}
]
}
],
"has_more": true
}
}
}