← 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.
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
| Service | Format | Example |
|---|---|---|
| UPS Standard | 1Z XXX XXX XX XXXX XXX X | 1Z999AA10123456784 |
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')) {
"success": true,
"data": [{
"carrier": "us.ups",
"status": "success",
"data": {
"deliveryStatus": "in_transit",
"events": [ … ]
},
"billable": true
}]
} - APer item:
successorerror— one bad number doesn't fail the batch. - BOne of nine values; UPS's wording is in
rawStatuson each event. - 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.
Related Resources
- 5-minute API setup guide — first request to webhook in cURL/Node/Python/Go
- Best parcel tracking API 2026 — 5-way comparison — WhereParcel vs AfterShip, 17TRACK, Tracktry, Parcellab
- Understanding tracking number formats by carrier — every major carrier's regex with examples
- Building a branded tracking page — Shopify, WooCommerce, custom
- Webhook best practices — signature verification, retries, idempotency
- Browse all 39+ live carriers
Start tracking UPS packages in minutes.
Read the Docs Open Playground