ImportOS · Docs
API reference

GET /v1/shipments

Shipments of a deal

Shipments of a deal

The container/bill of lading of the deal with tracking events. deal_id is required. Requires scope write:deals.

  • Authentication: header Authorization: Bearer rv_live_... (API keys and scopes)
  • Required scope: write:deals
Descriptions of the operation, parameters and fields come from the OpenAPI specification (openapi.json).

Parameters

FieldInTypeRequiredDescription
deal_idquerystring (uuid)yesDeal whose shipment to return.

Responses

200

Shipments of the deal.

application/json · Schema: ShipmentList

FieldTypeRequiredDescription
itemsobject[]yes
items[].idstring (uuid)no
items[].dealIdstring (uuid)no
items[].status"planned" | "booked" | "loaded" | "in_transit" | "at_port" | "discharged" | "released" | "delivered"no
items[].containerNostring | nullno
items[].billOfLadingstring | nullno
items[].vesselstring | nullno
items[].portFromstring | nullno
items[].portTostring | nullno
items[].etdstring | nullnoISO 8601 date-time (UTC).
items[].etastring | nullnoISO 8601 date-time (UTC).
items[].atastring | nullnoISO 8601 date-time (UTC).
items[].eventsobject[]no
items[].lastTrackedAtstring | nullnoISO 8601 date-time (UTC).
items[].warningsstring[]no

400

Invalid request parameters or body (code validation_error).

application/problem+json · Schema: Problem

401

Missing, malformed, unknown, revoked or expired API key (code unauthorized).

application/problem+json · Schema: Problem

403

The API key lacks the scope required by this endpoint (code insufficient_scope).

application/problem+json · Schema: Problem

404

Not found in this tenant.

application/problem+json · Schema: Problem

429

Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.

application/problem+json · Schema: Problem

On this page