Use CargoTrack's tracking API to create shipments, fetch delivery status, listen for webhook events, and give your users a clean package tracking experience.
{
"tracking_number": "CT00042",
"status": "in_transit",
"eta": "2026-05-08",
"current_location": "Processing Hub",
"events": [
{
"type": "picked_up",
"time": "2026-05-07T10:30:00Z"
},
{
"type": "in_transit",
"time": "2026-05-07T14:12:00Z"
}
]
}
CargoTrack gives your business the foundation for shipment creation, tracking status retrieval, customer updates, delivery events, and operational analytics.
Register new packages with destination details, customer reference, delivery type, and estimated delivery window.
Retrieve current package status, delivery progress, ETA, location notes, and full tracking event history.
Listen for pickup, delay, transit, out-for-delivery, failed delivery, and delivered events in real time.
Authenticate requests with API keys and protect business shipment data with secure server-side access.
Use these endpoints as the base structure for your future backend. The frontend can stay static now, then later connect to PHP, Node.js, Laravel, or FastAPI.
Returns the current delivery status, estimated delivery date, package stage, and tracking history.
| Parameter | Type | Description |
|---|---|---|
tracking_number |
string | Unique package tracking ID, for example CT00042. |
include_events |
boolean | Optional flag to return full delivery event history. |
Creates a new package record and returns a generated tracking number for customer visibility.
| Field | Type | Description |
|---|---|---|
customer_name |
string | Recipient or customer name. |
destination |
string | Final delivery location or city. |
package_weight |
number | Approximate package weight. |
reference_id |
string | Optional business order ID or invoice reference. |
Adds a new tracking event to a shipment timeline and updates the package's current status.
| Field | Type | Description |
|---|---|---|
status |
string | Current package state: registered, picked_up, processing, in_transit, delivered. |
location |
string | Current city, branch, hub, or delivery area. |
note |
string | Optional message shown to customer or internal operators. |
Returns delivery performance metrics for business dashboards and logistics reporting.
| Metric | Type | Description |
|---|---|---|
delivery_rate |
number | Percentage of packages successfully delivered. |
avg_delivery_time |
number | Average delivery time across selected shipments. |
failed_deliveries |
number | Total packages with failed delivery attempts. |
Webhooks let your system react automatically when shipment events happen, instead of repeatedly checking the API.
Add your endpoint URL where CargoTrack should send package status events.
A package moves from registered to picked up, processing, in transit, or delivered.
Your server receives a JSON payload containing the tracking number, status, timestamp, and location.
Send WhatsApp, SMS, email, or dashboard notifications to customers and operators.
Structure your future monetization around tracking volume, webhook access, analytics, and enterprise integrations.
CargoTrack can power tracking pages, seller dashboards, WhatsApp delivery alerts, mobile apps, logistics portals, and custom business workflows.