Parcel Tracker API
Create shipments and follow them from pickup to delivery. All requests use HTTPS and return JSON.
Quick start
- Get an API key from your dashboard.
- Send it in the
Authorizationheader. - Create your first shipment:
curl -X POST {BASE_URL}/v1/shipments \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"carrier": "dhl", "tracking_number": "JD014600006281"}'Get a shipment
GET /v1/shipments/{id}
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The shipment ID returned on creation |
{
"id": "shp_8f2k1",
"status": "in_transit",
"updated_at": "2026-10-05T09:14:00Z"
}Errors
| Code | Meaning | What to do |
|---|---|---|
| 401 | Missing or invalid key | Check the Authorization header |
| 404 | Unknown shipment | Check the ID |
| 429 | Too many requests | Wait and retry with backoff |