Create a tracking request
To track an ocean shipment, create a new tracking request. request_type and request_number are always required. Supply either a shipping line scac or set auto_detect_vocc_scac to true to have Terminal49 infer the SCAC from the request number before creating the tracking request.
Auto-detection uses the same carrier prediction capability as the Infer Tracking Number endpoint and runs asynchronously. The tracking request is created immediately (HTTP 201) with status: "pending"; if no supported carrier can be inferred it transitions to status: "failed" with failed_reason: "scac_auto_detect_failed" and no shipment is created. Once a tracking request is created we will attempt to fetch the shipment details and its related containers from the shipping line. If the attempt is successful we will create a 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 notification will only be sent if you have at least one active webhook. <br /><br /><Info>This endpoint is limited to 100 tracking requests per minute.</Info>
Request body
Example request
{
"data": {
"attributes": {
"request_type": "bill_of_lading",
"request_number": "MEDUFR030802",
"scac": "MSCU",
"auto_detect_vocc_scac": true
}
}
}Response
Tracking Request Created
Example response
{
"data": {
"attributes": {
"request_number": "ONEYSH9AME650500",
"request_type": "bill_of_lading",
"scac": "ONEY"
}
}
}