Skip to main content
POST
Get all flat shipping-rate thresholds for all shipping services
Part of the Shipping Options Details integration guide — see it for when and how to use this endpoint.

Headers

Authorization
string

The token retrieved via the GetAuthenticationToken API using merchant-specific credentials (provided to you by Global‑e).

UserName
string

The API UserName, provided to you by Global‑e.

Body

application/json
amount
number<float>
required

The shipping cost. This number can contain up to two digits after the decimal point. Example: 50.30.

currencyCode
string
required

The currency of the value passed in the amount parameter. Length: 3 letters. Example: CAD, USD, ILS, EUR.

cultureCode
string

Determines the shipping method description language. Default: en-GB.

destinationCountry
string

The destination country. Length: 2-3 letters (both ISO-2 and ISO-3 are supported). If empty, the API returns a list of shipping rates for all countries configured in the Global‑e System. Example: US or USA for the United States.

productCodes
string[]

The unique product reference (SKU, EAN, Barcode, and more). Example: ["product123","productABC"].

serviceLevel
enum<integer>

Supported service level. Default (omitted): revert to all shipping rates available, for instance, if the request is passed with amount = 0. Values: 1 - Standard, 2 - Express, 3 - PriorityPost, 4 - Airmail, 5 - VirtualGoods, 6 - ExpressCourierWithoutSameDay, 7 - UntrackedPost, 8 - StoreCollection, 9 - StandardPost, 10 - StandardCourier, 11 - ExpressShipping, 12 - StandardShipping, 13 - CollectionPoint, 14 - MerchantOwnCarriage, 15 - TrackedStandard, 16 - ExpressPlus, 17 - StandardExpress, 18 - PremiumStandard, 19 - TrackedPostToPickupLocation. The default output covers all service levels (express / standard).

Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19

Response

200 - application/json

An array of per-destination objects (ordered by destination country), each containing the destination, the shipping-methods availability status, and the array of available shipping rates by flat-rate shipping campaign.

destinationCountry
string

The destination country's ISO code.

status
enum<string>

Shipping methods availability. active: shipping methods were found for this destination. noShippingMethodsAvailable: no active shipping methods were found.

Available options:
active,
noShippingMethodsAvailable
shippingRates
ShippingRatesExtended · object[]

The available shipping rates for the destination, by flat-rate shipping campaign.