Frequently Asked Questions

WhereParcel is a unified package tracking API that lets developers track shipments from 500+ carriers worldwide through a single REST API endpoint. Instead of integrating with each carrier individually, you use one API with normalized JSON responses.

WhereParcel supports 500+ carriers across 16 countries, including major carriers like USPS, UPS, FedEx, DHL, Royal Mail, and many more.

We support carriers in the United States, South Korea, Japan, Germany, United Kingdom, Canada, Australia, China, India, Singapore, New Zealand, Ireland, South Africa, Hong Kong, Philippines, and international carriers for cross-border shipments.

Absolutely. WhereParcel is designed for e-commerce, logistics, and shipping platforms. Features like bulk tracking (up to 5 items per request), real-time webhooks for order status pages, and multi-carrier support make it ideal for online stores of any size.

Sign up for a free account, get your API key from the dashboard, and make your first tracking request in under 5 minutes. No credit card required.

After getting your API key, send a POST request to /v2/track with the carrier code and tracking number. We provide code examples in cURL, Node.js, Python, PHP, and Go. Check our quickstart guide for the full walkthrough.

Carrier codes follow the format {country}.{carrier} — for example, us.usps, kr.cjlogistics, jp.yamato, de.dhl. Use GET /v2/carriers to see the complete list of carrier codes.

Yes! Try our interactive API Playground to test tracking requests with sample data, no account needed.

Cached results return in under 500ms. Live carrier lookups typically complete in 2-3 seconds. We deploy across 5 global regions (US, Europe, Asia) to minimize latency regardless of your location.

Yes. Send up to 5 items with different carriers in a single POST /v2/track request. Each item needs a carrier code and tracking number. All results are returned in one response.

All API requests require an Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY header. Get your keys from the dashboard after signing up. Keys are transmitted over TLS-encrypted connections.

Currently, you must specify the carrier code with each tracking request. Auto-detection by tracking number format is planned for a future release.

Yes. We provide OpenAPI 3.0 specs in three languages: English (whereparcel.com/openapi.en.yaml), Korean (whereparcel.com/openapi.ko.yaml), and Japanese (whereparcel.com/openapi.ja.yaml).

Register a webhook endpoint URL, then subscribe tracking items. When a parcel's status changes, WhereParcel sends a POST request to your URL with the updated tracking data. No polling needed — you receive instant notifications. Read our webhook best practices guide for setup details.

With recurring: true, WhereParcel continuously monitors the package and sends updates on every status change until delivery. With recurring: false, we perform a single lookup and send the result once.

Yes. If your endpoint is temporarily unavailable, WhereParcel automatically retries webhook deliveries with exponential backoff to ensure you don't miss important status updates.

Yes. WhereParcel offers a free plan — no credit card required. You get access to all 500+ carriers and can upgrade as your volume grows. See pricing plans.

Starter ($15/mo) includes 10,000 requests and webhooks. Pro ($29/mo) includes 30,000 requests and priority support. Business ($199/mo) includes 300,000 requests, dedicated support, and 99.95% SLA. Compare plans.

Yes, rate limits depend on your plan. Rate limits vary by plan — from 1 request/minute on Free to 200/minute on Business. See our rate limits guide for details.

No. WhereParcel uses transparent, per-request pricing. You only pay for the plan you choose. No setup fees, no hidden charges, and no long-term contracts.