Skip to main content
GET
List Shipments

Authorizations

Authorization
string
header
required

A brand-scoped or global amb_sk_... API key.

Path Parameters

brand
string
required

Brand slug authorized by this API key.

Example:

"acme"

Query Parameters

cursor
string

Opaque nextCursor from the same collection and filters. Omit on the first request.

limit
integer
default:25
Required range: 1 <= x <= 100
shipmentCode
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
trackingNumber
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
carrier
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
carrierSlug
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
freightForwarder
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
shipmentMode
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
houseBillNumber
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
masterBillNumber
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
externalShipmentId
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
externalBookingReference
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
source
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
status
string

Exact, case-sensitive match. Spaces and punctuation are literal.

Required string length: 1 - 255
dischargeLocationId
string

Exact related entity ID.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
pickupLocationId
string

Exact related entity ID.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
containerNumber
string

Exact member of containerNumbers.

Required string length: 1 - 255
originId
string
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
destinationId
string
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

One page. totalItems counts the full filtered set; nextCursor null means exhausted.

items
object[]
required
nextCursor
string | null
required
totalItems
integer
required
Required range: 0 <= x <= 9007199254740991