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:
- A WhereParcel account (sign up here)
- An API key from your dashboard
- Basic knowledge of REST APIs
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:
- API Playground — Test any carrier interactively in your browser
- Authentication Guide - Learn about API key security best practices
- Webhook Setup - Get automatic delivery notifications
- Carrier List - See all 39+ live carriers (request more anytime)
- 5-Minute Setup Guide with Production Checklist — Multi-carrier setup, code in cURL/Node.js/Python/Go, webhooks, and a production-ready checklist
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 →