Frequently Asked Questions

WhereParcel is a unified package tracking API that lets developers track shipments from 43+ live carriers in production (with rapid on-request additions) through a single REST API endpoint. Instead of integrating with each carrier individually, you use one API with normalized JSON responses.

WhereParcel currently supports 43+ carriers across 11 countries, including USPS, UPS, FedEx, DHL, Royal Mail, OnTrac, Yamato, Japan Post, and more. Don't see your carrier? Request it on our community board — we add new carriers quickly.

We support carriers in the United States, South Korea, Japan, Germany, United Kingdom, Canada, Australia, Italy, Spain, Turkey, 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, pick a plan, get your API key from the dashboard, and make your first tracking request in under 5 minutes. Cancel anytime — you keep access until the end of your billing period.

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, gb.royalmail. 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.

There's no free trial — you start on a paid plan and can cancel anytime, keeping access until the end of your billing period. Access to all 43+ live carriers starts immediately. Already subscribed? One short post about WhereParcel earns you 3 months free through our Ambassador program. See pricing plans.

Starter ($49/mo) includes 10,000 requests and webhooks. Pro ($99/mo) includes 30,000 requests and priority support. Business ($650/mo) includes 300,000 requests, dedicated support, and 99.95% SLA. You can cancel any plan at any time. Compare plans.

Yes, rate limits depend on your plan. Rate limits vary from 30 requests/minute on Starter up 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.