Track123 API — unlocking tracking capabilities for 1,700+ global carriers

Query real-time tracking data from 1,700+ global carriers through a single Track123 API — millisecond response, 99.99% uptime.

View API docs

Trusted by 60,000+ businesses worldwide

为什么选择 TRACK123
Built for global logistics and e-commerce tracking

In cross-border e-commerce, logistics platforms, and SaaS systems, packages often span multiple countries and carriers.

Track123 provides a unified shipping tracking API to help you integrate quickly and run reliably.

One API replaces multiple integrations
No need to integrate each carrier separately — one integration covers them all, significantly reducing development and maintenance costs.
Unified tracking for domestic and international shipments
Supports complex routes including cross-border direct shipping, overseas warehouses, and last-mile delivery — full-chain tracking with a single shipment number.
Fewer "Where's my package?" inquiries
Improve shipping visibility so buyers always know their order status, significantly reducing WISMO customer service load.
Track123 supports 1,700+ global carriers
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
Track123 by the Numbers
99.99%
API uptime
1700+
Global carrier integrations
1.5B+
total shipments tracked
60000+
businesses served
2M+
Daily queries
<1天
From sign-up to go-live
Advanced Tracking API
1700+ Carriers ● Real-time
Real-time response
Millisecond response, syncing global shipping status in real time
Track123 API is designed for high-concurrency, high-frequency queries, ensuring you get the latest shipping updates instantly at any scale.
Sub-100ms API response — supports creating shipments, querying tracking, and fetching the latest status
Covers 1,700+ global carriers, supporting cross-border direct shipping, overseas warehouses, and last-mile delivery
Real-time Webhook push — instant callback when tracking changes, no polling needed
Supports high-concurrency scenarios — suitable for order peaks, e-commerce sales events, and platform-level systems
Shipping status updates sync to your system, frontend, or notification flow within seconds
TRACKING NUMBER
9261290100830368973 · USPS
✓ Delivered
Pending pickup In transit Delivery failed Out for redelivery Signed ✓
Delivered
Austin, TX, US · Mar 18, 14:23
DELIVERED
Out for redelivery
Austin, TX, US · Mar 18, 09:05
OUT_FOR_DELIVERY
Delivery failed · Unable to access address
Austin, TX, US · Mar 17, 15:47
DELIVERY_FAILED
First delivery attempt
Austin, TX, US · Mar 17, 09:12
OUT_FOR_DELIVERY
Arrived at sorting center
Dallas, TX, US · Mar 16, 22:34
IN_TRANSIT
Pending pickup
Los Angeles, CA, US · Mar 15, 10:08
INFO_RECEIVED
AI-powered processing
From raw, chaotic tracking data to standardized logistics data
More accurate, clearer, and more trustworthy logistics data. AI automatically normalizes raw tracking data from different carriers into ready-to-use standardized data.
Automatically normalized into 8 core statuses + 28 sub-statuses
Unified handling of pickup time, transit nodes, delivery time, location names, and timezone differences
Supports full-chain integration for multi-carrier relay shipping — get complete updates with a single tracking number
AI automatically identifies new carriers and tracking number rules, continuously improving recognition accuracy
Especially suited for cross-border logistics, Dropshipping, platform-based systems, and SaaS products
「API测试页」企业稳定区块正常运行率图表标题
99.99%
100ms
Avg. response time
0
Incidents this month
Enterprise-grade reliability
A long-term stable API built for enterprise systems
Track123 ensures long-term API availability and consistency, so you can focus on your business instead of maintaining infrastructure.
SLA 99.99%, meeting the availability requirements of platform-level and SaaS systems
Distributed architecture + multi-node redundancy to eliminate single points of failure
Smart degradation and fault tolerance to handle carrier API fluctuations
Long-term maintenance and version compatibility to avoid disruptive changes
Proven in long-term production use across global e-commerce sellers, logistics platforms, and SaaS systems
Full API docs
RESTful + Webhook dual mode
Sample code
「API测试页」集成示例代码语言列表
Enterprise SLA
24/7 technical support
● Operational
Integrate in as little as 1 day
Sign up and start — no credit card required
Quick integration
Seamless enterprise integration with end-to-end technical support
Track123 means you don’t need to invest heavily in maintaining carrier integrations or worry about future scaling and customization needs.
Full API documentation with clear structure and stable fields for rapid onboarding
Sample code in multiple languages to reduce repetitive development effort
Standard RESTful API + Webhook to easily embed into existing systems
Go live in as little as 1 day — validate fast, launch fast
24/7 technical support with enterprise custom solutions and dedicated SLAs
Integration steps
Four steps to complete your tracking integration

One integration covers all carriers. No need to maintain individual interfaces.

01

Sign up to get your API key

Sign up for a free Track123 account and get your API key instantly — the whole process takes under 5 minutes.

02

Submit tracking numbers

Submit tracking numbers to Track123 via API — no need to specify a carrier in advance. The system identifies it automatically.

03

Automatic identification and lookup

Track123 automatically identifies the carrier and retrieves the latest tracking data from the corresponding logistics system.

04

Get results or receive push notifications

Retrieve standardized tracking data via API, or receive real-time status updates via Webhook.

View API docs
API demo
Real API, real data

Select a tracking number to see Track123 API’s real request and response structure.

REQUEST · CURL
curl --request POST \
--url https://api.track123.com/gateway/open-api/tk/v2.1/track/query \
--header Track123-Api-Secret: XXXXXXXXXXXXXXX \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"trackNoInfos": [
{
"trackNo": "9500109441760092147847"
"courierCode": "usps"
}
]
}'
RESPONSE
  {  "code": "00000",  "data": {    "accepted": {      "content": [        {          "id": "824300786983985152",          "trackNo": "9500109441760092147847",          "createTime": "2026-03-24 15:17:02",          "nextUpdateTime": "2026-04-02 15:17:10",          "shipFrom": "US",          "shipTo": "US",          "trackingStatus": "001",          "transitStatus": "ABNORMAL",          "transitSubStatus": "ABNORMAL_08",          "receiptTime": "2026-01-17 08:26:00",          "lastTrackingTime": "2026-02-20 12:52:00",          "transitDays": 74,          "stayDays": 39,          "localLogisticsInfo": {            "courierCode": "usps",            "courierNameCN": "美国邮政",            "courierNameEN": "USPS",            "courierHomePage": "https://www.usps.com/",            "courierTrackingLink": "https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=9500109441760092147847",            "trackingDetails": [              {                "address": "",                "eventTime": "2026-02-20 12:52:00",                "eventTimeZeroUTC": "2026-02-20T16:52:00Z",                "timezone": "-04:00",                "eventDetail": "Sent to Mail Recovery Center",                "transitSubStatus": "ABNORMAL_03"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-02-20 12:47:00",                "eventTimeZeroUTC": "2026-02-20T16:47:00Z",                "timezone": "-04:00",                "eventDetail": "Out for Delivery",                "transitSubStatus": "WAITING_DELIVERY_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-02-20 12:36:00",                "eventTimeZeroUTC": "2026-02-20T16:36:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at Post Office",                "transitSubStatus": "IN_TRANSIT_07"              },              {                "address": "",                "eventTime": "2026-01-31 00:00:00",                "eventTimeZeroUTC": "2026-01-31T04:00:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-27 02:02:00",                "eventTimeZeroUTC": "2026-01-27T06:02:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-27 01:52:00",                "eventTimeZeroUTC": "2026-01-27T05:52:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-27 01:21:00",                "eventTimeZeroUTC": "2026-01-27T05:21:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-27 00:58:00",                "eventTimeZeroUTC": "2026-01-27T04:58:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-26 21:49:00",                "eventTimeZeroUTC": "2026-01-27T01:49:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-26 15:50:00",                "eventTimeZeroUTC": "2026-01-26T19:50:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-25 12:05:00",                "eventTimeZeroUTC": "2026-01-25T16:05:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-25 00:27:00",                "eventTimeZeroUTC": "2026-01-25T04:27:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-24 23:41:00",                "eventTimeZeroUTC": "2026-01-25T03:41:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-24 21:34:00",                "eventTimeZeroUTC": "2026-01-25T01:34:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-23 01:56:00",                "eventTimeZeroUTC": "2026-01-23T05:56:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-23 01:54:00",                "eventTimeZeroUTC": "2026-01-23T05:54:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-23 01:26:00",                "eventTimeZeroUTC": "2026-01-23T05:26:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-22 19:31:00",                "eventTimeZeroUTC": "2026-01-22T23:31:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-22 18:41:00",                "eventTimeZeroUTC": "2026-01-22T22:41:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-22 15:53:00",                "eventTimeZeroUTC": "2026-01-22T19:53:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "DALLAS,TX",                "eventTime": "2026-01-22 13:01:00",                "eventTimeZeroUTC": "2026-01-22T17:01:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "DALLAS,TX",                "eventTime": "2026-01-22 09:59:00",                "eventTimeZeroUTC": "2026-01-22T13:59:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-21 23:08:00",                "eventTimeZeroUTC": "2026-01-22T03:08:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "",                "eventTime": "2026-01-21 13:21:00",                "eventTimeZeroUTC": "2026-01-21T17:21:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NEWARK NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 05:09:00",                "eventTimeZeroUTC": "2026-01-21T09:09:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NEWARK NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 02:43:00",                "eventTimeZeroUTC": "2026-01-21T06:43:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "TRENTON NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 01:28:00",                "eventTimeZeroUTC": "2026-01-21T05:28:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "TRENTON NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-19 17:02:00",                "eventTimeZeroUTC": "2026-01-19T21:02:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-19 14:53:00",                "eventTimeZeroUTC": "2026-01-19T18:53:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "WARRENDALE PA DISTRIBUTION CENTER",                "eventTime": "2026-01-19 11:19:00",                "eventTimeZeroUTC": "2026-01-19T15:19:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-18 19:19:00",                "eventTimeZeroUTC": "2026-01-18T23:19:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "",                "eventTime": "2026-01-18 03:30:00",                "eventTimeZeroUTC": "2026-01-18T07:30:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-17 09:26:00",                "eventTimeZeroUTC": "2026-01-17T13:26:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-17 08:26:00",                "eventTimeZeroUTC": "2026-01-17T12:26:00Z",                "timezone": "-04:00",                "eventDetail": "Accepted at USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              }            ]          },          "shipmentType": "USPS - USPS Ground Advantage"        }      ],      "totalElements": "1407",      "totalPages": "15",      "currentPage": "1",      "cursor": "2"    },    "rejected": []  },  "msg": "Success",  "traceId": "59f9e3940adc405986a3ea484bdf7a2b"}
FAQ
Got questions? We've got answers
What is the Track123 tracking API? +
The Track123 tracking API is a multi-carrier interface that gives your system or platform real-time access to complete shipment status, including main status, sub-status, and exception events. It supports data integration and standardized output from 1,700+ global carriers.
Why choose a multi-carrier API over single-carrier integrations? +
Single-carrier interfaces only return data from one carrier. Cross-border e-commerce and large-scale retail typically involve multiple carriers, each requiring a separate integration—at high maintenance cost. With the Track123 multi-carrier API, one integration gives you access to all carriers, significantly reducing development effort and accelerating your business reach.
What is the stability and SLA of the Track123 API? +
Track123 offers enterprise-grade SLA with 99.99% API uptime. Globally distributed nodes ensure low-latency responses. Real-time monitoring, alerts, and dedicated technical support keep your business running without interruption.
How does the Track123 API protect data security and privacy? +
Track123 uses an enterprise-grade security architecture, including HTTPS encrypted transmission, API key authentication, IP allowlist controls, and data masking. It meets international data security standards to keep your business data and user information safe and in your control at all times.
How is the Track123 API priced? +
Track123 offers subscription plans. The base plan includes a free quota; usage beyond that is billed per query. Enterprise customers can request a custom plan with dedicated quota, advanced SLA, and priority technical support. See the pricing page for details.
How do I get started with the Track123 API? +
Simply sign up, get your API key, and follow the documentation to integrate quickly. Track123 provides detailed integration docs, Postman examples, and an SDK to help you go live within hours—no lengthy waits or complex approval processes required.

Get started with Track123 API

Works with e-commerce platforms, logistics services, and internal enterprise systems. Build a visual tracking experience in as little as 1 day, keeping customers informed of their order status at all times.

View API docs