USPS tracking broken since the API changes? We fix it in minutes: one key, no OAuth, 1,000 lookups free.

USPS Tracking APIAnswer “Where’s my package?” with live status, through one API key.

Show live USPS status inside your store, app or support desk. One API key, clean JSON, batch lookups and webhooks, built for e-commerce teams in the US, Europe and Asia.

Get 1,000 free lookups Read the docs

1,000 free lookups · Self-serve signup · Public pricing

Try a live USPS lookup

5 free live lookups left today

USPS

USPS TRACKING #

9589 0710 5270 2634 8701 31

In transit

Your item is in transit to the next facility.

In Transit to Next Facility
— · November 11, 2026 9:18 AM
Departed USPS Regional Facility
CHICAGO, IL 60607 · November 11, 2026 3:14 AM
Arrived at USPS Regional Destination Facility
CHICAGO, IL 60607 · November 10, 2026 9:12 PM
USPS in possession of item
DALLAS, TX 75260 · November 9, 2026 7:36 PM

{
  "trackingNumber": "9589071052702634870131",
  "found": true,
  "delivered": false,
  "status": "In Transit",
  "statusDetail": "In Transit to Next Facility",
  "statusCategory": "in-transit",
  "latestUpdate": "Your item is in transit to the next facility.",
  "mailingDate": "2026-11-09",
  "product": {
    "name": "USPS Ground Advantage™",
    "features": [
      "USPS Tracking®",
      "Up to $100 insurance included"
    ]
  },
  "events": [
    {
      "status": "In Transit to Next Facility",
      "date": "November 11, 2026 9:18 AM",
      "localTime": "2026-11-11T09:18:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T09:18:00-06:00"
    },
    {
      "status": "Departed USPS Regional Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 11, 2026 3:14 AM",
      "localTime": "2026-11-11T03:14:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T03:14:00-06:00"
    },
    {
      "status": "Arrived at USPS Regional Destination Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 10, 2026 9:12 PM",
      "localTime": "2026-11-10T21:12:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-10T21:12:00-06:00"
    },
    {
      "status": "USPS in possession of item",
      "location": "DALLAS, TX 75260",
      "city": "DALLAS",
      "state": "TX",
      "zip": "75260",
      "date": "November 9, 2026 7:36 PM",
      "localTime": "2026-11-09T19:36:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-09T19:36:00-06:00"
    }
  ],
  "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
  "fetchedAt": "2026-11-11T18:00:00.000Z"
}

Example200 OK · 3.4 s

Average response time: 3.5s
Success rate: >99%
Customers and users: 2,000+
Per 1,000 lookups on the 1M plan: $5

Why Wonca

A simpler alternative to the official USPS API

Since the 2026 platform changes, building on USPS APIs means OAuth apps, quota requests and access reviews. Wonca turns all of that into one endpoint.

	Building on USPS directly	Wonca USPS API
Authentication	OAuth 2.0 app and token refresh	One API key in a header
Getting access	Developer portal, approvals, account linking	Sign up and generate a key in minutes
Volume	Default quotas; increases requested manually	From 25,000 to 1M+ lookups per month
Many numbers at once	One tracking number per call	Batch lookups in one request
Status changes	Build and run your own polling	Webhooks pushed to your endpoint
Cost	Engineering time plus licensing terms	Public plans from $199 per month

Wonca is not the official USPS API. We are an independent data processing and organization service: we take USPS tracking information and deliver it to your system clean, standardized and ready to use.

Capabilities

Track USPS packages at scale: single lookups, batches and webhooks

Single lookup

Send a USPS tracking number and get status and full event history back as JSON, in about 3.5 s on average.

Batch lookups

Check many tracking numbers in one operation. Ideal for nightly syncs and order dashboards.

Monitoring & webhooks

Full event history

Timestamps, locations and USPS event descriptions for every scan, from acceptance to delivered.

Works with any stack

If it speaks HTTPS and reads JSON, it works: Node, Python, PHP, Java, Shopify apps, ERPs and no-code tools.

Predictable billing

Monthly quota, flat price, every feature included. No add-ons and no surprise invoices.

Use cases

Built for the teams that run on USPS

E-commerce brands

Answer “Where is my order?” before it becomes a ticket, with live USPS status on order pages and emails.

Cross-border sellers

Shipping from China, Europe or Latin America into the US? Follow the USPS last mile in one place.

3PLs & fulfillment

Feed USPS events into your WMS or OMS and alert clients the moment a parcel stalls.

Support & CX teams

Give agents and chatbots the real answer instantly, without opening usps.com.

How it works

Integrate USPS tracking in three steps

Create your key
Sign up and generate an API key in your dashboard. Your first 1,000 lookups are free.
Send a tracking number
POST the USPS number over HTTPS with your key in the Authorization header.
Use the response
Show status in your store, trigger emails, or push events to your systems with webhooks.

Open the technical guide

curl -X POST \
  https://api.wonca.com.br/wonca.labs.v1.LabsService/Track \
  -H "Authorization: Apikey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "9589071052702634870131", "carrier": "CARRIER_USPS" }'

{
  "payload": {
    "trackingNumber": "9589071052702634870131",
    "found": true,
    "delivered": false,
    "status": "In Transit",
    "statusDetail": "In Transit to Next Facility",
    "statusCategory": "in-transit",
    "latestUpdate": "Your item is in transit to the next facility.",
    "mailingDate": "2026-11-09",
    "product": {
      "name": "USPS Ground Advantage™",
      "features": [
        "USPS Tracking®",
        "Up to $100 insurance included"
      ]
    },
    "events": [
      {
        "status": "In Transit to Next Facility",
        "date": "November 11, 2026 9:18 AM",
        "localTime": "2026-11-11T09:18:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T09:18:00-06:00"
      },
      {
        "status": "Departed USPS Regional Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 11, 2026 3:14 AM",
        "localTime": "2026-11-11T03:14:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T03:14:00-06:00"
      },
      {
        "status": "Arrived at USPS Regional Destination Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 10, 2026 9:12 PM",
        "localTime": "2026-11-10T21:12:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-10T21:12:00-06:00"
      },
      {
        "status": "USPS in possession of item",
        "location": "DALLAS, TX 75260",
        "city": "DALLAS",
        "state": "TX",
        "zip": "75260",
        "date": "November 9, 2026 7:36 PM",
        "localTime": "2026-11-09T19:36:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-09T19:36:00-06:00"
      }
    ],
    "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
    "fetchedAt": "2026-11-11T18:00:00.000Z"
  },
  "carrier": "CARRIER_USPS",
  "status": "TRACKING_STATUS_FOUND"
}

Pricing

USPS Tracking API pricing. Every feature on every plan.

Choose a monthly lookup quota that renews every billing cycle. Need more than 1 million lookups? We build the plan around you.

1,000free lookups

Free when you sign up

Your first 1,000 lookups are on us.

Create your account, generate a key and run real USPS tracking numbers through your own system. Enough to track your next 1,000 orders before you pay for a plan.

Real USPS data, not a sandbox
Self-serve setup in minutes
Pick a plan only when you are ready

Get 1,000 free lookups

Starter
For new stores and pilots
$199/month
25,000
lookups / month
$7.96 per 1,000 lookups
Choose plan
Growth
For growing shops
$399/month
50,000
lookups / month
$7.98 per 1,000 lookups
Choose plan
Most popular
Scale
For established brands
$749/month
100,000
lookups / month
$7.49 per 1,000 lookups
Save 6% vs. Starter
Choose plan
Business
For marketplaces and 3PLs
$2,999/month
500,000
lookups / month
$6.00 per 1,000 lookups
Save 25% vs. Starter
Choose plan
Enterprise
For high-volume operations
$5,000/month
1,000,000
lookups / month
$5.00 per 1,000 lookups
Save 37% vs. Starter
Choose plan
Partner
For large partners above 1M lookups / month
1M+
lookups / month
Custom
As low as $0.20 per 1,000 lookups
Up to 97% off
vs. the Starter rate, depending on your volume
- Volume tiers negotiated with you
- Dedicated contact and direct line
- Custom setup, billing and onboarding
Talk to sales

Included in every plan:

Single and batch USPS lookups
Monitoring and webhooks
Full event history in JSON
HTTPS and API key auth
Docs and email support

USPS Tracking API FAQ

Something we didn't cover? Tell us your volume and stack, and we'll point you to the right plan.

Talk to sales

How much can I test for free?

Your first 1,000 lookups are free. Create your account, generate a key and test the API with real USPS tracking numbers. Choose a plan only when you are ready to go live.

What happens when the free lookups run out?

Choose a plan to keep tracking. The free lookups are available for a limited time after you sign up, so use them while you test your integration.

What counts as a lookup?

Each tracking request uses one lookup from your monthly quota. Quotas renew every billing cycle.

How fast is the API?

The average response time is 3.5 seconds for a live USPS lookup, with a success rate above 99%.

Is this the official USPS API?

No. Wonca is an independent data processing and organization service, not affiliated with USPS. We handle USPS tracking information and deliver it as clean, standardized JSON, so your team does not have to deal with the official integration.

Do I need my own USPS developer account?

No. You only need a Wonca API key. We handle the connection to USPS.

Can I track many numbers at once?

Yes. Use batch lookups for several tracking numbers in one operation, or monitoring with webhooks to receive updates automatically.

Will it work with my platform?

Yes, as long as your system can send HTTPS requests and read JSON: any language, ERP, e-commerce platform or automation tool.

What if I need more than 1 million lookups?

The Enterprise plan covers 1 million lookups for $5,000 a month ($5 per 1,000). Above that, our Partner plan gives large partners custom pricing as low as $0.20 per 1,000 (up to 97% off), with a dedicated contact.

Do you support other carriers?

Yes. Besides USPS, we also track Correios (Brazil), CAINIAO, and J&T Express (Brazil).

Put live USPS tracking in front of your customers today.

Start with 1,000 free lookups, then go live from $199 a month, or talk to us about volume.

Get 1,000 free lookups Talk to sales