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, CJ Logistics, Hanjin Express, Yamato Transport, Sagawa Express, 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 500 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 at whereparcel.com/signup. 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 docs at whereparcel.com/docs for the full quickstart guide.

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 at whereparcel.com/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 500 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.

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 tier with 1,000 tracking requests per month. No credit card required. You get access to all 500+ carriers and can upgrade as your volume grows.

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

Yes, rate limits depend on your plan. The free tier allows 100 requests per day, 1,000 per month. Paid plans have higher limits. Check our pricing page 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.