Getting Started
In Depth Guides
Useful Info
Shipments
Tracking Requests
Tracking requests
Webhooks
Webhook Notifications
Containers
Shipping Lines
Terminals
Get a single tracking request
Get the details and status of an existing tracking request.
Token YOUR_API_TOKEN
The APIs require authentication to be done using header-based API Key and Secret Authentication.
API key and secret are sent va the Authorization
request header.
You send your API key and secret in the following way:
Authorization: Token YOUR_API_KEY
Tracking Request ID
Comma delimited list of relations to include. 'tracked_object' is included by default.
{
"data": {
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "tracking_request",
"attributes": {
"request_number": "MEDUFR030802",
"request_type": "bill_of_lading",
"scac": "MSCU",
"ref_numbers": [],
"created_at": "2020-04-04T16:13:35-07:00",
"status": "created",
"failed_reason": null
},
"relationships": {
"tracked_object": {
"data": {
"id": "eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83",
"type": "shipment"
}
}
},
"links": {
"self": "/v2/tracking_requests/ba4cb904-827f-4038-8e31-1e92b3356218"
}
},
"included": [
{
"id": "eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83",
"type": "shipment",
"attributes": {
"created_at": "2020-04-04T16:13:37-07:00",
"bill_of_lading_number": "MEDUFR030802",
"ref_numbers": [],
"shipping_line_scac": "MSCU",
"shipping_line_name": "Mediterranean Shipping Company",
"port_of_lading_locode": "FRFOS",
"port_of_lading_name": "Fos-Sur-Mer",
"port_of_discharge_locode": "USOAK",
"port_of_discharge_name": "Oakland",
"pod_vessel_name": "MSC ALGECIRAS",
"pod_vessel_imo": "9605243",
"pod_voyage_number": "920A",
"destination_locode": "USOAK",
"destination_name": "Oakland",
"destination_timezone": "America/Los_Angeles",
"destination_ata_at": "2019-06-21T18:46:00-07:00",
"destination_eta_at": null,
"pol_etd_at": null,
"pol_atd_at": "2019-05-24T03:00:00-07:00",
"pol_timezone": "Europe/Paris",
"pod_eta_at": null,
"pod_ata_at": "2019-06-21T18:46:00-07:00",
"pod_timezone": "America/Los_Angeles"
},
"relationships": {
"port_of_lading": {
"data": {
"id": "6d8c6c29-72a6-49ad-87b7-fd045f202212",
"type": "port"
}
},
"port_of_discharge": {
"data": {
"id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7",
"type": "port"
}
},
"pod_terminal": {
"data": null
},
"destination": {
"data": {
"id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7",
"type": "port"
}
},
"containers": {
"data": [
{
"id": "11c1fa10-52a5-48e2-82f4-5523756b3d0f",
"type": "container"
}
]
}
},
"links": {
"self": "/v2/shipments/eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83"
}
}
]
}
Authorizations
Token YOUR_API_TOKEN
The APIs require authentication to be done using header-based API Key and Secret Authentication.
API key and secret are sent va the Authorization
request header.
You send your API key and secret in the following way:
Authorization: Token YOUR_API_KEY
Path Parameters
Tracking Request ID
Query Parameters
Comma delimited list of relations to include. 'tracked_object' is included by default.
Response
Was this page helpful?
{
"data": {
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "tracking_request",
"attributes": {
"request_number": "MEDUFR030802",
"request_type": "bill_of_lading",
"scac": "MSCU",
"ref_numbers": [],
"created_at": "2020-04-04T16:13:35-07:00",
"status": "created",
"failed_reason": null
},
"relationships": {
"tracked_object": {
"data": {
"id": "eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83",
"type": "shipment"
}
}
},
"links": {
"self": "/v2/tracking_requests/ba4cb904-827f-4038-8e31-1e92b3356218"
}
},
"included": [
{
"id": "eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83",
"type": "shipment",
"attributes": {
"created_at": "2020-04-04T16:13:37-07:00",
"bill_of_lading_number": "MEDUFR030802",
"ref_numbers": [],
"shipping_line_scac": "MSCU",
"shipping_line_name": "Mediterranean Shipping Company",
"port_of_lading_locode": "FRFOS",
"port_of_lading_name": "Fos-Sur-Mer",
"port_of_discharge_locode": "USOAK",
"port_of_discharge_name": "Oakland",
"pod_vessel_name": "MSC ALGECIRAS",
"pod_vessel_imo": "9605243",
"pod_voyage_number": "920A",
"destination_locode": "USOAK",
"destination_name": "Oakland",
"destination_timezone": "America/Los_Angeles",
"destination_ata_at": "2019-06-21T18:46:00-07:00",
"destination_eta_at": null,
"pol_etd_at": null,
"pol_atd_at": "2019-05-24T03:00:00-07:00",
"pol_timezone": "Europe/Paris",
"pod_eta_at": null,
"pod_ata_at": "2019-06-21T18:46:00-07:00",
"pod_timezone": "America/Los_Angeles"
},
"relationships": {
"port_of_lading": {
"data": {
"id": "6d8c6c29-72a6-49ad-87b7-fd045f202212",
"type": "port"
}
},
"port_of_discharge": {
"data": {
"id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7",
"type": "port"
}
},
"pod_terminal": {
"data": null
},
"destination": {
"data": {
"id": "42d1ba3a-f4b8-431d-a6fe-49fd748a59e7",
"type": "port"
}
},
"containers": {
"data": [
{
"id": "11c1fa10-52a5-48e2-82f4-5523756b3d0f",
"type": "container"
}
]
}
},
"links": {
"self": "/v2/shipments/eb6f218a-0b4a-47f9-8ef9-759aa5e0ea83"
}
}
]
}