Versão obsoleta

Está a consultar a documentação de v2.x, que está obsoleta e já não é atualizada. Pondere atualizar para v3.x. Ir para v3.x

Esta página ainda não está disponível no seu idioma

Está a lê-la em English (UK).

List consignments

get

/consignments

listConsignments

Returns a page of consignments, newest first.

Changed in 2.0. Paging is by cursor rather than by page number; the value comes from the previous response's next field.

Autorização

Qualquer um destes
- apiKeyapiKey · X-Api-Key · Cabeçalho
  A key from the account page.
Qualquer um destes
- bearerhttp · bearer
  A token obtained from the authorisation server.

Parâmetros

Consulta

limitintegermín 1máx 100
How many consignments to return.
cursorstring
Where to continue from.

Respostas

200

A page of consignments.

application/json

object

items*Obrigatórioarray<object>
Cada elemento
objectConsignmentConsignmentOne consignment, as 2.x sees it.
- id*ObrigatóriostringApenas leitura
- reference*Obrigatóriostringcomprimento mín 1comprimento máx 120Called `label` in 1.x.
- status*Obrigatóriostringbooked | sailing | landedCalled `state` in 1.x. `cancelled` is new in 3.x.
- createdAtstringApenas leitura
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"
    }
  ],
  "next": "string"
}

400

Something went wrong, described the same way every time.

application/problem+json

objectProblem

title*Obrigatóriostring
status*Obrigatóriointegermín 400máx 599

json

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

Enviar um pedido

curl 'https://api.example.org/v2/consignments?limit=20&cursor=string'

Editar esta página