whereparcel

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

← United States Carriers

Carrier·United States·us.ups

UPS Tracking API

Track UPS packages with WhereParcel's unified tracking API. Support for Ground, Next Day Air, 2nd Day Air, and all UPS services. Unified JSON response format.

Open Playground Read the Docs View Pricing

UPSSheet 1 of 1

Carrier Code
us.ups
Country
🇺🇸 United States
Status
Live
Number formats
1 — UPS Standard
Per request
1 tracking number (synchronous)
Response
The same JSON shape as all 39+ live carriers

UPS Tracking Number Formats

ServiceFormatExample
UPS Standard1Z XXX XXX XX XXXX XXX X1Z999AA10123456784

Quick Start

Track UPS packages with a single API call:

curl -X POST https://api.whereparcel.com/v2/track \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "trackingItems": [{
      "carrier": "us.ups",
      "trackingNumber": "1Z999AA10123456784"
    }]
  }'
const response = await fetch('https://api.whereparcel.com/v2/track', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}:${SECRET_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    trackingItems: [{
      carrier: 'us.ups',
      trackingNumber: '1Z999AA10123456784',
    }],
  }),
});

const { data } = await response.json();
console.log(data[0].data?.deliveryStatus);
// → "in_transit", "delivered", etc.
import requests

response = requests.post(
    'https://api.whereparcel.com/v2/track',
    headers={
        'Authorization': f'Bearer {API_KEY}:{SECRET_KEY}',
        'Content-Type': 'application/json',
    },
    json={
        'trackingItems': [{
            'carrier': 'us.ups',
            'trackingNumber': '1Z999AA10123456784',
        }],
    },
)

item = response.json()['data'][0]
print(item.get('data', {}).get('deliveryStatus'))

200Response·abridged

{
  "success": true,
  "data": [{
    "carrier": "us.ups",
    "status": "success",
    "data": {
      "deliveryStatus": "in_transit",
      "events": [ … ]
    },
    "billable": true
  }]
}
  1. APer item: success or error — one bad number doesn't fail the batch.
  2. BOne of nine values; UPS's wording is in rawStatus on each event.
  3. CCache hits come back with billable: false.

Automatic Updates with Webhooks

Instead of polling, register a webhook and we re-check your UPS parcels about every 12 hours, pushing each status to you. Each tracking number counts as just 1 request — no matter how many updates follow.

// Register a webhook endpoint
await fetch('https://api.whereparcel.com/v2/webhook-endpoints', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}:${SECRET_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Production',
    url: 'https://yourapp.com/webhooks/tracking',
    description: 'UPS tracking updates',
  }),
});

Why WhereParcel for UPS

  • Unified JSON — same response shape across UPS and the rest of our 39+ live carriers. No carrier-specific branching code.
  • Honest pricing — Starter $49/mo (10K req), Pro $99/mo (30K), Business $650/mo (300K). Cancel anytime.
  • Free 3 months — write one short blog post mentioning WhereParcel via the ambassador program and get 3 months of Starter free.
  • Don't see a carrier? — Request it on our community board — we add new carriers fast.

Try without signup

Use our free Tracking Number Validator to paste any UPS number and instantly see the carrier and service type — no account needed, runs entirely in your browser.

Try with sample UPS number →

Related Resources

Start tracking UPS packages in minutes.

Read the Docs Open Playground