Version à venir

Vous consultez la documentation d’une version à venir. Sa documentation et ses fonctionnalités peuvent encore changer.

Cette page n’est pas encore disponible dans votre langue

Vous la lisez en English (UK).

List consignments

get

/consignments

listConsignments

Returns a page of consignments, newest first.

Paging is by cursor; the value comes from the previous response's next field and is opaque.

Autorisation

L’un de ceux-ci suffit
- apiKeyapiKey · X-Api-Key · En-tête
  A key from the account page.
L’un de ceux-ci suffit
- bearerhttp · bearer
  A token obtained from the authorisation server.

Paramètres

Requête

limitintegermin 1max 100
How many consignments to return.
cursorstring
Where to continue from.
statusarray<string>uniques
Chaque élément
stringConsignmentStatusbooked | loading | sailing | landed | cancelledWhere a consignment has got to.
Only consignments in these states.
style=form explode=false
sessionstring
The same session, for callers that cannot set the cookie — a page cannot, because `Cookie` is a header the browser refuses to let a script write. Deliberately the same *name* in a second location: OpenAPI identifies a parameter by the pair `(name, in)`, so these are two parameters, and a reference that keyed its try-it form on the name alone would send one box's answer to both.

En-tête

X-Request-Idstring
An identifier echoed back on every response.

Cookie

sessionstring
An optional session, for a personalised order.

Réponses

200

A page of consignments.

En-têtes

X-Request-Id*Obligatoirestring

object

items*Obligatoirearray<object>7
Chaque élément
objectConsignmentOne consignment, as the API sees it.
- id*ObligatoirestringLecture seule
- reference*Obligatoirestringlongueur min 1longueur max 120
- status*ObligatoirestringConsignmentStatusbooked | loading | sailing | landed | cancelledWhere a consignment has got to.
- createdAtstringLecture seule
- parentanyConsignmentSe référence lui-même ; déplié plus haut.
- tagsarray<string>uniques
  Chaque élément
  string
- metadataobject
  Toute autre propriété
  string
nextstring | nullThe cursor for the following page, if any.

json

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

Que faire ensuite

NextPagelistConsignments
The same call again, with `cursor` set from `next`.

400

Something went wrong, described the same way every time.

application/problem+json

objectProblem

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

json

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

default

Something went wrong, described the same way every time.

application/problem+json

objectProblem

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

json

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

Envoyer une requête

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'

Modifier cette page