whereparcel

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

Frequently Asked Questions

Everything you need to know about WhereParcel's package tracking API. Can't find what you're looking for? Ask on our community board.

General

What is WhereParcel?
WhereParcel is a unified package tracking API that lets developers track shipments from 39+ 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.
How many carriers does WhereParcel support?
WhereParcel currently supports 39+ carriers across 9 countries + international, including USPS, UPS, FedEx, DHL, OnTrac, Yamato, Japan Post, and more. Don't see your carrier? Request it on our community board — we add new carriers quickly.
Which countries are supported?
We support carriers in the United States, Canada, United Kingdom, Germany, Italy, Spain, Japan, South Korea, Turkey, and international carriers for cross-border shipments.
Is WhereParcel suitable for e-commerce platforms?
Absolutely. WhereParcel is designed for e-commerce, logistics, and shipping platforms. Features like bulk tracking (up to 5 items per request), webhooks for order status pages, and multi-carrier support make it ideal for online stores of any size.

Getting Started

How do I get started?
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.
How do I integrate WhereParcel into my application?
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.
What carrier code format do you use?
Carrier codes follow the format {country}.{carrier} — for example, us.usps, us.ups, jp.yamato, intl.dhl. Use GET /v2/carriers to see the complete list of carrier codes.
Can I test the API before signing up?
Yes! Try our interactive API Playground to test tracking requests with sample data, no account needed.

API & Technical

What is the API response time?
Cached results return in under 500ms. Live carrier lookups typically complete in 2-3 seconds. The API is served from the US East region.
Can I track multiple packages in one request?
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.
What authentication method do you use?
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.
Do you support auto-detection of carriers?
Yes. POST /v2/detect returns likely carriers from the tracking number format alone — free, no usage counted. Pick the candidate with the highest specificityScore, then track with that carrier code.
Is there an OpenAPI specification available?
Yes. We provide an OpenAPI 3.0 spec at whereparcel.com/openapi.en.yaml.

Webhooks & Notifications

How do webhooks work?
Register a webhook endpoint URL, then subscribe tracking items. WhereParcel re-checks each parcel about every 12 hours and sends a POST request to your URL with the latest tracking data after every check (hasChanges tells you whether the status changed). No polling needed on your side. Read our webhook best practices guide for setup details.
What is the difference between recurring and one-time webhooks?
With recurring: true, WhereParcel re-checks the package about every 12 hours and sends an update after every check, until it is delivered or 10 days have passed. With recurring: false, we perform a single lookup and send the result once.
Does WhereParcel retry failed webhook deliveries?
No. WhereParcel sends each webhook once. If your endpoint is down or returns an error, that delivery isn't resent — you can still read every change with GET /v2/webhooks/subscriptions/{requestId}/changes, and the next status change is delivered as usual.

Pricing & Billing

Can I try WhereParcel for free?
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 39+ live carriers starts immediately. Already subscribed? One short post about WhereParcel earns you 3 months free through our Ambassador program. See pricing plans.
Is there a rate limit?
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.
Are there any hidden fees?
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.

Still have questions?

Ask on our community board and get answers from our team and other developers.

Visit Community