whereparcel

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

Tutorial 8 min read

Getting Started with WhereParcel API

Learn how to integrate WhereParcel's global package tracking API into your application in under 10 minutes. Track 39+ live carriers with a single API (request more anytime).

WhereParcel Team

WhereParcel provides a unified API to track parcels from 39+ live carriers worldwide today, with new carriers added quickly on user request. Whether you’re building an e-commerce platform, logistics dashboard, or customer notification system, our API makes it simple to get real-time tracking data.

Prerequisites

Before you begin, make sure you have:

Step 1: Get Your API Key

After signing up, navigate to the Dashboard and create a new API key. Your key will look something like this:

wp_live_a1b2c3d4e5f6g7h8i9j0

Keep this key secure and never expose it in client-side code.

Step 2: Make Your First Request

Here’s how to track a parcel using our API:

curl -X POST https://api.whereparcel.com/v2/track \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
  -d '{
    "trackingItems": [{ "carrier": "us.usps", "trackingNumber": "9400111899562537866361" }]
  }'

Step 3: Parse the Response

The API returns a standardized tracking response regardless of the carrier:

{
  "success": true,
  "data": [
    {
      "carrier": "us.usps",
      "trackingNumber": "9400111899562537866361",
      "status": "success",
      "data": {
        "deliveryStatus": "in_transit",
        "estimatedDelivery": "2026-02-05",
        "events": [
          {
            "timestamp": "2026-02-01T10:30:00Z",
            "status": "in_transit",
            "location": "Chicago, IL Distribution Center",
            "description": "Package picked up from sender"
          }
        ],
        "lastUpdated": "2026-02-01T10:30:00Z"
      },
      "billable": true,
      "cached": false
    }
  ],
  "summary": {
    "total": 1,
    "success": 1,
    "failed": 0,
    "usageIncremented": 1
  }
}

What’s Next?

Now that you’ve made your first request, explore these topics:

Happy tracking!

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: #api #quickstart #integration