Misc

Detect Carrier From Tracking Number

0calls

2 credits / call

Not sure which carrier a tracking number belongs to? This endpoint identifies the carrier without performing a tracking lookup.

GET

uapis.cn

/api/v1/misc/tracking/detect

Query parameters

tracking_number

string

required

Tracking number to identify.

Overview

Given a tracking number, the endpoint quickly identifies the most likely carrier based on tracking-number format. If multiple carriers match, the alternatives are returned in the alternatives field.

Usage notes

Fast: Pattern-matching only; no tracking is fetched. Typical response time is under 100 ms.
Accurate: Carrier rules are tuned to match each carrier’s number format with above-95% accuracy.
Multiple matches: When the format is ambiguous, all matching carriers are returned.

Query parameters

tracking_number

stringrequired

Tracking number to identify.

Name	Type	Attributes	Description
`tracking_number`	string	required	Tracking number to identify.

Response

200 / OK

Detection succeeded. Returns the matched carrier and any alternatives.

JSON

{
  // Tracking number being identified.
  "tracking_number": "SF1234567890123",
  // Detected carrier code.
  "carrier_code": "shunfeng",
  // Detected carrier name.
  "carrier_name": "顺丰速运",
  // Other matching carriers. Empty array when there are no alternatives.
  "alternatives": [
    {
      // Carrier code.
      "code": "ems",
      // Carrier name.
      "name": "EMS"
    }
  ]
}

404 / Not Found

Cannot identify the tracking number.

JSON

{
  "code": "NO_MATCH",
  "message": "Cannot identify the tracking number"
}

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/misc/tracking/detect?tracking_number='

Frequently asked questions

Are there any special restrictions for the Detect Carrier From Tracking Number API?

Detect Carrier From Tracking Number follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

Related APIs

Track Express Shipments

Want to know where your package is right now? This endpoint returns real-time tracking history.

List Supported Carriers

Not sure which carriers the API supports? This endpoint returns the full directory.

Phone Number Location Lookup

Want to know where a phone number is from, and which carrier it belongs to? This endpoint gives you the answer.

Query IP

Want to know where an IP address or domain comes from? This endpoint can help you locate it. Returns standard results by default; if you pass source=commercial, more complete location information will be returned.

PreviousTrack Express Shipments

NextList Supported Carriers