curl --request PATCH \
--url https://api.terminal49.com/v2/tracking_requests/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"attributes": {
"ref_number": "REFNUMBER11"
}
}
}
'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "tracking_request",
"attributes": {
"request_number": "ONEYSH9AME650500",
"status": "pending",
"request_type": "bill_of_lading",
"scac": "ONEY",
"created_at": "2023-11-07T05:31:56Z",
"ref_numbers": [
"<string>"
],
"tags": [
"<string>"
],
"failed_reason": "booking_cancelled",
"updated_at": "2023-11-07T05:31:56Z",
"is_retrying": true,
"retry_count": 123
},
"relationships": {
"tracked_object": {
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "shipment"
}
},
"customer": {
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "party"
}
}
}
}
}Update a tracking request
curl --request PATCH \
--url https://api.terminal49.com/v2/tracking_requests/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"attributes": {
"ref_number": "REFNUMBER11"
}
}
}
'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "tracking_request",
"attributes": {
"request_number": "ONEYSH9AME650500",
"status": "pending",
"request_type": "bill_of_lading",
"scac": "ONEY",
"created_at": "2023-11-07T05:31:56Z",
"ref_numbers": [
"<string>"
],
"tags": [
"<string>"
],
"failed_reason": "booking_cancelled",
"updated_at": "2023-11-07T05:31:56Z",
"is_retrying": true,
"retry_count": 123
},
"relationships": {
"tracked_object": {
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "shipment"
}
},
"customer": {
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "party"
}
}
}
}
}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
OK
Show child attributes
tracking_request Show child attributes
"ONEYSH9AME650500"
pending, awaiting_manifest, created, failed, tracking_stopped bill_of_lading, booking_number, container "bill_of_lading"
4"ONEY"
If the tracking request has failed, or is currently failing, the last reason we were unable to complete the request
booking_cancelled, duplicate, expired, internal_processing_error, invalid_number, not_found, retries_exhausted, shipping_line_unreachable, unrecognized_response, data_unavailable, How many times T49 has attempted to get the shipment from the shipping line
Show child attributes
Was this page helpful?