Home Open Platform DocsFBA Freight

FBA Freight Rate Query

Query FBA freight rates by Amazon FBA warehouse code + weight. Covers major US West / US East FBA warehouses, aggregates multiple provider channels, and returns final external quotes sorted by total amount ascending. 2 credits/call.

Endpoint Info

Endpoint	POST /api/openapi/v1/freight/fba/search
Credit cost	2 credits / call
Data freshness	Daily
Timeout suggestion	Client timeout ≥ 3s

Request Parameters

Field	Type	Required	Description	Example
fba_code	string	Yes	Amazon FBA warehouse code (3 uppercase letters + 1 digit)Look up code ↗	FTW1 / ONT8 / LAX9
weight	number	Yes	Actual cargo weight in kg (chargeable weight = max(weight, min_weight), max 5000)	21.5
pol_code	string	No	Origin port code (restricts to a port group; default unrestricted)Look up code ↗	CNSZX / CNGZG
goods_type	int	No	Goods type (default 1, general cargo)	1

Response Fields

Field	Type	Description
resolved.fba_code	string	Echo of the parsed FBA warehouse code (normalized to uppercase)
list[]	array	Channel list, sorted by total_amount ascending
list[].channel_name	string	Channel name (external-facing display name)
list[].fba_code	string	FBA warehouse code
list[].zip_code	string	FBA warehouse zip code
list[].pol_group	string	Origin port group (e.g. "South China Port Group", "East China Port Group")
list[].min_weight	number	Channel minimum chargeable weight in kg (chargeable = max(weight, min_weight))
list[].chargeable_weight	number	Actual chargeable weight in kg
list[].unit_price	number	External unit price per kg
list[].total_amount	number	Total amount (unit_price × chargeable_weight)
list[].currency	string	Currency (default CNY)
list[].tt	string	Estimated transit time (e.g. "25-30 days")
list[].remarks	string	Channel remarks (last-mile delivery / duty terms / peak season / operational requirements; merged from multiple sources separated by "/")
credit_used	int	Credits deducted for this call
credit_balance	int	Remaining credits after deduction

Full curl Example

curl -X POST https://www.5688.cn/api/openapi/v1/freight/fba/search \
  -H "Content-Type: application/json" \
  -H "X-Awice-AppKey: AK_xxxxxxxxxxxxxxxx" \
  -H "X-Awice-Timestamp: 1746086400" \
  -H "X-Awice-Nonce: a1b2c3d4e5f6a7b8" \
  -H "X-Awice-Signature: 7f8e9d6c5b4a..." \
  -d '{
    "fba_code": "FTW1",
    "weight": 21.5,
    "pol_code": "CNSZX"
  }'

Successful Response

{
  "code": 0,
  "msg": "success",
  "request_id": "req_xxxxxxxxxxxxxxxx",
  "data": {
    "resolved": { "fba_code": "FTW1" },
    "list": [
      {
        "channel_name": "US FBA Ocean - DDP",
        "fba_code": "FTW1",
        "zip_code": "76177",
        "pol_group": "South China port group",
        "min_weight": 21,
        "chargeable_weight": 21.5,
        "unit_price": 18.5,
        "total_amount": 397.75,
        "currency": "CNY",
        "tt": "25-30 days",
        "remarks": "Includes last-mile delivery / excludes duties / may be delayed in peak season"
      }
    ]
  },
  "credit_used": 2,
  "credit_balance": 9498
}

Empty Data Response

When the queried fba_code has no available channels, an empty list is returned. Credits are still deducted, so we recommend validating the code in advance via the FBA Warehouse List.

{
  "code": 0,
  "msg": "success",
  "request_id": "req_xxxxxxxxxxxxxxxx",
  "data": {
    "resolved": { "fba_code": "XYZ9" },
    "list": []
  },
  "credit_used": 2,
  "credit_balance": 9498
}

Notes:

FBA warehouse codes must be formatted as 3 uppercase letters + 1 digit (FTW1/ONT8/LAX9, etc.); look them up in the Warehouse List
total_amount is already the final external quote — the client does not need to multiply by weight again
min_weight is the channel's minimum chargeable threshold: if actual is 21kg and min_weight is 50kg, billed at 50kg
When pol_code is omitted, all port groups are covered by default (primarily Shenzhen / Dongguan / Guangzhou / Zhongshan South China Port Group)

Next: Reference Data