# WhereParcel

> Unified parcel tracking API for 500+ carriers across 16 countries. Track USPS, UPS, FedEx, DHL, CJ Logistics, Yamato, and more with a single REST API.

WhereParcel provides a single API endpoint to track packages from 172+ carriers worldwide. Instead of building separate integrations for each carrier, developers use one unified API with normalized JSON responses, real-time webhook notifications, and bulk tracking support.

## Quick Facts

- API Base URL: https://api.whereparcel.com
- Authentication: API key + Secret key (header-based)
- Response format: JSON
- OpenAPI 3.0 spec available at: https://whereparcel.com/openapi.en.yaml
- Languages: English, Korean, Japanese
- Free trial: 7-day free trial on all paid plans (card required, one trial per card). Instant no-signup testing: public demo key, 20 requests/day per IP

## Free Tools (No API Key Required)

- [Spreadsheet Tracker](https://whereparcel.com/tools/spreadsheet-tracker): Track parcels in bulk directly from Excel or Google Sheets — no coding required
  - **Excel VBA Macro** (.xlsm): Download and run SetupAll, then Register Tracking + Fetch Results. Windows only.
  - **Google Apps Script** (Code.gs): Copy the template or paste Code.gs into Extensions > Apps Script. Works on Mac, Windows, Chromebook.
  - Supports 200+ carriers, up to 100 items per batch, color-coded status, auto carrier code normalization
  - Downloads: https://whereparcel.com/downloads/WhereParcel_Tracker.xlsm | https://whereparcel.com/downloads/TrackingMacro.bas | https://whereparcel.com/downloads/Code.gs
  - Google Sheets template: https://docs.google.com/spreadsheets/d/13OQEGzTlFHzG8xj31ldPYq6L0IQPozgSc_eWfdTP64g/copy

## Documentation

- [API Docs](https://whereparcel.com/docs): Quick start guide, authentication, code examples
- [Tracking API](https://whereparcel.com/docs/api/tracking): Single and batch tracking endpoints
- [Carriers API](https://whereparcel.com/docs/api/carriers): Query 172+ supported carriers by country
- [Webhooks API](https://whereparcel.com/docs/api/webhooks): Real-time push notifications for status changes
- [Webhook Endpoints API](https://whereparcel.com/docs/api/webhook-endpoints): Manage webhook receiver URLs
- [Supported Carriers](https://whereparcel.com/carriers): Full list of 172+ carriers across 16 countries
- [API Playground](https://whereparcel.com/playground): Interactive API testing tool

## API Endpoints

- POST /v2/track — Track single or batch parcels (up to 5 items)
- GET /v2/carriers — List all supported carriers
- GET /v2/countries — List supported countries
- GET /v2/carriers/{countryCode} — Get carriers by country
- POST /v2/webhooks/register — Register webhook subscriptions
- GET /v2/webhooks/subscriptions — List active subscriptions
- POST /v2/webhook-endpoints — Create webhook endpoint
- GET /v2/webhook-endpoints — List webhook endpoints

## Pricing

All plans include a 7-day free trial. Cancel within 7 days — no charge.

- Starter: 10,000 requests/month, $49/mo, webhooks, email support
- Pro: 30,000 requests/month, $99/mo, priority support, advanced analytics
- Growth: 100,000 requests/month, $250/mo, priority support
- Scale: 200,000 requests/month, $450/mo, dedicated support
- Business: 300,000 requests/month, $650/mo, dedicated support, 99.95% SLA

## Coverage

16 countries: South Korea, United States, Japan, China, Germany, United Kingdom, Canada, Australia, India, Singapore, New Zealand, Ireland, South Africa, Hong Kong, Philippines, and international carriers.

Major carriers include: USPS, UPS, FedEx, DHL, Korea Post, CJ Logistics, Hanjin Express, Lotte Global Logistics, Japan Post, Yamato Transport, Sagawa Express, Royal Mail, Canada Post, Australia Post, and more.