Upcoming version

You're browsing the documentation for an upcoming version. Its documentation and features are subject to change.

Read a consignment

GET /consignments/{consignmentId}

get

/consignments/{consignmentId}

getConsignment

Authorisation

Any one of these
- apiKeyapiKey · X-Api-Key · Header
  A key from the account page.
Any one of these
- bearerhttp · bearer
  A token obtained from the authorisation server.

Parameters

Path

consignmentId*Requiredstring
The consignment's own identifier.

Responses

200

The consignment.

application/json

objectConsignmentOne consignment, as the API sees it.

id*RequiredstringRead-only
reference*Requiredstringmin length 1max length 120
status*RequiredstringConsignmentStatusbooked | loading | sailing | landed | cancelledWhere a consignment has got to.
createdAtstringRead-only
parentanyConsignmentRefers to itself; expanded above.
tagsarray<string>unique
Each item
string
metadataobject
Any other property
string

json

{
  "id": "00000000-0000-4000-8000-000000000000",
  "reference": "string",
  "status": "booked",
  "createdAt": "2026-01-01T09:00:00Z",
  "parent": null,
  "tags": [
    "string"
  ],
  "metadata": {}
}

404

Something went wrong, described the same way every time.

application/problem+json

objectProblem

title*RequiredstringA short, human-readable summary.
status*Requiredintegermin 400max 599
detailstring | null

json

{
  "title": "string",
  "status": 400,
  "detail": "string"
}

Send a request

curl 'https://api.example.org/v3/consignments?limit=20&cursor=string&status=%5B%0A++%22booked%22%0A%5D&session=string' \
  -H 'Authorization: Bearer demo-token' \
  -H 'X-Request-Id: 00000000-0000-4000-8000-000000000000'

Edit this page