Sign in
Tracking Requests

Create a tracking request

To track an ocean shipment, you create a new tracking request. Two attributes are required to track a shipment. A bill of lading/booking number and a shipping line SCAC.

Once a tracking request is created we will attempt to fetch the shipment details and it's related containers from the shipping line. If the attempt is successful we will create in new shipment object including any related container objects. We will send a tracking_request.succeeded webhook notification to your webhooks.

If the attempt to fetch fails then we will send a tracking_request.failed webhook notification to your webhooks.

A tracking_request.succeeded or tracking_request.failed webhook notificaiton will only be sent if you have atleast one active webhook. <br /><br /><Info>This endpoint is limited to 100 tracking requests per minute.</Info>

post/tracking_requests

Request body

Example request

{
  "data": {
    "attributes": {
      "request_type": "bill_of_lading",
      "request_number": "MEDUFR030802",
      "scac": "MSCU"
    }
  }
}

Response

Tracking Request Created

Example response

{
  "data": {
    "attributes": {
      "request_number": "ONEYSH9AME650500",
      "request_type": "bill_of_lading",
      "scac": "ONEY"
    }
  }
}

Changes