Skip to main content
POST
/
tracking_requests
/
infer_number
curl --request POST \
  --url https://api.terminal49.com/v2/tracking_requests/infer_number \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "WHLU1234560"
}
'
{
  "data": {
    "id": "req_123e4567-e89b-12d3-a456-426614174000",
    "type": "infer_number_results",
    "attributes": {
      "number_type": "container",
      "validation": {
        "is_valid": true,
        "type": "container",
        "check_digit_passed": true,
        "parsed_number": null,
        "reason": null
      },
      "shipping_line": {
        "decision": "auto_select",
        "selected": {
          "scac": "WHLC",
          "name": "Wan Hai Lines",
          "confidence": 1
        },
        "candidates": [
          {
            "scac": "WHLC",
            "name": "Wan Hai Lines",
            "confidence": 1
          }
        ]
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://terminal49-codex-docs-audit-diataxis-skill.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Beta Feature - This endpoint is currently in beta. The API is stable, but the schema and behavior may evolve based on feedback.

What this endpoint does

Provide a tracking number (container, bill of lading, or booking). The endpoint returns:
  • The predicted VOCC carrier SCAC to use for tracking
  • The predicted number type
  • A confidence-driven decision (auto_select, needs_confirmation, no_prediction)
Terminal49 uses machine learning prediction across container, bill of lading, and booking numbers. For container numbers, Terminal49 leverages tens of millions of historical container movements to predict which carrier is moving the container (about 9 out of 10 times).

How to use the result

This endpoint has its own rate-limit bucket: 200 requests per minute per API key.

Auto-Detect Carrier Guide

Learn how to use Infer Tracking Number to reliably create tracking requests

Authorizations

Authorization
string
header
required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Body

application/json
number
string
required

The tracking number to analyze (container number, bill of lading, or booking number)

Example:

"WHLU1234560"

Response

Successfully inferred number type and shipping line

data
object