{"uid":"cap_OSE5bSnPm0lpg6rOh3rxq","slug":"x402-multi-carrier-package-tracker-ce891007","name":"x402 Multi-Carrier Package Tracker","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-tools/shipping/track","method":"POST","headers":{},"bodySchema":{"type":"object","required":["tracking_number"],"properties":{"carrier":{"type":"string","description":"Optional carrier slug. Live: fedex, usps, dhl. In rollout: ups. Roadmap (returns 'coming soon'): canada_post, la_poste, royal_mail, australia_post, evri, deutsche_post, postnl, china_post, japan_post, india_post, correos, poste_italiane, aramex, yodel, swiss_post, correios, ems, ontrac, amazon_shipping. Aliases accepted (hermes→evri, auspost→australia_post, etc.). Auto-detected from tracking number format if omitted."},"tracking_number":{"type":"string","description":"Carrier-issued tracking number (e.g. '391629465360' for FedEx, '9400111202555842761991' for USPS, '1Z999AA10123456784' for UPS)"}}},"responseSchema":{"type":"object","properties":{"hint":{"type":"string","description":"Present on failure — actionable guidance for the caller"},"error":{"type":"string","description":"Present on failure"},"events":{"type":"array","description":"Full event timeline: timestamp, status, description, location"},"status":{"type":"string","description":"Normalized status: delivered, out_for_delivery, in_transit, picked_up, label_created, exception, returned, unknown"},"weight":{"type":"string","description":"Package weight"},"carrier":{"type":"string","description":"Resolved canonical carrier slug"},"service":{"type":"string","description":"Service level (e.g. 'FedEx Ground', 'Priority Mail')"},"shipper":{"type":"object","description":"Origin address (city, state, postal_code, country)"},"success":{"type":"boolean"},"recipient":{"type":"object","description":"Destination address (city, state, postal_code, country)"},"actual_delivery":{"type":"string","description":"ISO 8601 actual delivery time when delivered"},"tracking_number":{"type":"string"},"estimated_delivery":{"type":"string","description":"ISO 8601 ETA when known"},"status_description":{"type":"string","description":"Carrier-provided human-readable status text"}}},"example":{"request":{"carrier":"fedex","tracking_number":"391629465360"},"response":{"events":[{"status":"delivered","location":"Tualatin, OR, US","timestamp":"2025-08-03T11:38:58-07:00","description":"Delivered"},{"status":"in_transit","location":"SHERWOOD, OR, US","timestamp":"2025-08-03T07:14:00-07:00","description":"On FedEx vehicle for delivery"},{"status":"in_transit","location":"SHERWOOD, OR, US","timestamp":"2025-08-03T07:10:00-07:00","description":"At local FedEx facility"},{"status":"in_transit","location":"TROUTDALE, OR, US","timestamp":"2025-08-02T23:34:52-07:00","description":"Departed FedEx location"},{"status":"in_transit","location":"TROUTDALE, OR, US","timestamp":"2025-08-02T12:34:00-07:00","description":"Arrived at FedEx location"},{"status":"in_transit","location":"REDDING, CA, US","timestamp":"2025-08-02T01:07:22-07:00","description":"On the way"},{"status":"in_transit","location":"AVENAL, CA, US","timestamp":"2025-08-01T13:06:09-07:00","description":"On the way"},{"status":"in_transit","location":"SAN DIEGO, CA, US","timestamp":"2025-08-01T00:58:51-07:00","description":"Left FedEx origin facility"},{"status":"in_transit","location":"SAN DIEGO, CA, US","timestamp":"2025-07-31T19:35:00-07:00","description":"Arrived at FedEx location"},{"status":"picked_up","location":"SAN DIEGO, CA, US","timestamp":"2025-07-31T15:26:00-07:00","description":"Picked up"},{"status":"unknown","location":"US","timestamp":"2025-07-31T10:34:00-07:00","description":"Shipment information sent to FedEx"}],"status":"delivered","weight":"8.0 LB","carrier":"fedex","service":"FedEx Home Delivery","shipper":{"city":"El Cajon","state":"CA","country":"US","postal_code":null},"success":true,"recipient":{"city":"Tualatin","state":"OR","country":"US","postal_code":null},"actual_delivery":"2025-08-03T11:38:58-07:00","tracking_number":"391629465360","status_description":"Delivered"}},"exampleRequest":{"carrier":"fedex","tracking_number":"391629465360"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_k3oCAAbnXFWdASRwvmUGs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Tracks packages in real-time across FedEx, USPS, DHL (and UPS in rollout) given a tracking number and optional carrier slug","exampleAgentPrompt":"Can you track my FedEx package with tracking number 274899172985? I want to see its current status and delivery history.","exampleUseCases":[{"title":"Customer service agent handling support inquiries","prompt":"A customer just emailed saying they haven't received their package yet. They gave me a tracking number 1Z445AA7 but didn't mention which carrier. Can you look up the package status and tell me where it is and when it should arrive?"},{"title":"E-commerce bot updating order status","prompt":"One of our customers is asking about their shipment. I have the tracking number 794613851294 but I'm not sure if it went out via DHL or USPS. Can you check the real-time tracking and give me the latest delivery status and location?"},{"title":"Logistics reconciliation for multi-carrier operations","prompt":"I need to verify the delivery status for multiple shipments across different carriers. Can you track package 9400111899223456789 and show me the complete tracking history including all the events, timestamps, and locations so I can see exactly what's happening with this delivery?"}],"resultDescription":"Returns real-time shipment status, carrier identification, tracking event history (timestamps, locations, status codes), and estimated delivery information for the given tracking number. For carriers on the roadmap but not yet live, returns a 'coming soon' response that logs demand.","failureModes":["Invalid or unrecognized tracking number returns an error or empty result","Carrier not yet supported returns 'coming soon' placeholder","UPS tracking may be incomplete or unavailable during rollout","Network or upstream carrier API timeout causes delayed or failed response","Missing required tracking_number field causes a 400-style error"],"whenToPreferThis":"Use this endpoint when you need real-time package tracking for FedEx, USPS, or DHL shipments (or UPS in rollout) and want a unified multi-carrier API rather than integrating each carrier separately. Ideal for AI agents that need to answer 'where is my package?' queries without knowing which carrier to query in advance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:44.480Z","isFirstParty":false}