---
title: "Infer Tracking Number"
method: POST
path: "/tracking_requests/infer_number"
tags: ["Tracking Requests"]
---

# Infer Tracking Number

`POST /tracking_requests/infer_number`

Predict the carrier SCAC (VOCC) and number type from a tracking number. Provide a container number, bill of lading number, or booking number and receive the predicted carrier with confidence and a decision value. Use this to auto-populate carrier fields before creating a tracking request.

## Request body

- object
  - `number` string, required — The tracking number to analyze (container number, bill of lading, or booking number)

## Response `200`

Successfully inferred number type and shipping line

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `number_type` 'container' | 'bill_of_lading' | 'booking'
      - `validation` object
        - `is_valid` boolean, nullable
        - `type` 'container' | 'shipment'
        - `check_digit_passed` boolean, nullable
        - `parsed_number` string, nullable
        - `reason` string, nullable
      - `shipping_line` object
        - `decision` 'auto_select' | 'needs_confirmation' | 'no_prediction'
        - `selected` object, nullable
          - `scac` string
          - `name` string
          - `confidence` number
        - `candidates` object[]
          - `scac` string
          - `name` string
          - `confidence` number

## Other responses

- `422` — Unprocessable Entity - Invalid tracking number format
- `429` — Too Many Requests - Rate limit exceeded

## Changes

> 54 revisions in range; 25 could not be searched.

- **2025-12-18** `55830b8e5400` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/tracking_requests/infer_number/post.md)

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/998a27e39c03/schema)