Start tracking a container, bill of lading, or booking

post/v1/containers

Request

  • Base URL: https://api.trackingmcp.com
  • URL: https://api.trackingmcp.com/v1/containers
  • Auth: HTTP bearer

Request body

identifierstring required
identifier_type'container_id' | 'bill_of_lading' | 'booking' required
carrier_codestring

Optional SCAC hint; auto-resolved from the container prefix when omitted.

tagsstring[]
tracked_fromstring date-time

Journey floor for a re-used container number (ISO 8601 date or date-time). Events dated before it are dropped from derivation and the timeline, so a container reused on a new booking scopes to the current sailing instead of a delivered prior journey. Applies to container-number registrations; bill_of_lading and booking references already pin the journey and ignore it.

bl_numberstring

Bill of lading number sent with a container identifier. Required when carrier_code names a line that tracks only by the bill of lading and the container number together (JJCU, Shanghai Jinjiang); ignored for every other line.

container_numberstring

Container number (4 letters and 7 digits) sent with a bill_of_lading or booking identifier. Required when carrier_code names a line that tracks only by the bill of lading and the container number together (JJCU, Shanghai Jinjiang); ignored for every other line.

Response

Container accepted and tracking started.

oktrue required
api_versionstring

The response contract this build answers, as a date. Pin it in your client.

Changes

No recorded changes to this operation across all 1 revision of this API.