whereparcel

Stuck on integration? Have a question? The developer is standing by.

Guide 7 min read

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:

  1. Deutsche Post (pickup in Germany and international handoff)
  2. 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:

RegionCountriesMajor Carriers
North AmericaUSA, CanadaUPS, FedEx, USPS
EuropeUK, Germany, ItalyFedEx UK, Deutsche Post, Poste Italiane
AsiaJapan, KoreaYamato, 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

  1. Detect the carrier first - /v2/detect is free and needs no carrier lookup
  2. Set up webhooks - International shipments take days; don’t poll
  3. Handle time zones - All timestamps are in UTC
  4. 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 →

Tags: #international #carriers #tracking