Tracking Parcels Across Borders: A Complete Guide
Everything you need to know about tracking international parcels across different carriers and countries.
WhereParcel Team
International parcel tracking has always been complex. A single shipment might pass through 3-4 different carriers as it crosses borders. WhereParcel solves this by providing a single API that works with 39+ live carriers across 9 countries + international (with rapid on-request additions).
The Challenge of International Tracking
When you ship a package from Berlin to New York, it might travel through:
- Deutsche Post (pickup in Germany and international handoff)
- USPS (US domestic delivery)
Each carrier has its own tracking system, data format, and API. Without a unified solution, you’d need to integrate with each one separately.
How WhereParcel Handles Cross-Border Tracking
Our API automatically detects carrier handoffs and merges tracking events from multiple carriers into a single timeline:
{
"trackingNumber": "CP123456789DE",
"status": "in_transit",
"events": [
{
"carrier": "de.post",
"timestamp": "2026-02-01T09:00:00Z",
"status": "picked_up",
"location": "Berlin, Germany"
},
{
"carrier": "de.post",
"timestamp": "2026-02-03T14:00:00Z",
"status": "departed",
"location": "Frankfurt Airport, Germany"
},
{
"carrier": "us.usps",
"timestamp": "2026-02-05T08:00:00Z",
"status": "arrived",
"location": "JFK Airport, New York, USA"
},
{
"carrier": "us.usps",
"timestamp": "2026-02-06T11:00:00Z",
"status": "out_for_delivery",
"location": "Manhattan, New York, USA"
}
]
}
Supported Countries
WhereParcel supports carriers from major e-commerce regions:
| Region | Countries | Major Carriers |
|---|---|---|
| North America | USA, Canada | UPS, FedEx, USPS |
| Europe | UK, Germany, Italy | FedEx UK, Deutsche Post, Poste Italiane |
| Asia | Japan, Korea | Yamato, CJ Logistics |
Getting Started with International Tracking
The API call is the same whether you’re tracking domestic or international parcels:
# 1. Find the carrier — free: format matching only, no lookup, no usage
curl -X POST https://api.whereparcel.com/v2/detect \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"trackingNumber": "CP123456785DE"}'
# 2. Track it with the best match (here de.post)
curl -X POST https://api.whereparcel.com/v2/track \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"trackingItems": [{"carrier": "de.post", "trackingNumber": "CP123456785DE"}]}'
Don’t know the carrier? POST /v2/detect returns every carrier whose format matches the number, each with a specificityScore — track with the highest one.
Tips for International Tracking
- Detect the carrier first -
/v2/detectis free and needs no carrier lookup - Set up webhooks - International shipments take days; don’t poll
- Handle time zones - All timestamps are in UTC
- Expect gaps - Some carriers update less frequently during transit
For the full list of supported carriers, visit our Carriers documentation.
Can't find your carrier? We add new carriers on request — just let us know.
Request a carrier →Got a question? Just ask. Drop by our Discord — the developer behind WhereParcel reads every message and replies personally. No bots, no tickets, just a real conversation.
Join Discord → Join Slack →