# x402 Multi-Carrier Package Tracker

> x402 Multi-Carrier Package Tracker is a paid API for AI agents from x402.onchainexpat.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Tracks packages in real-time across FedEx, USPS, DHL (and UPS in rollout) given a tracking number and optional carrier slug

## Facts

- Endpoint: POST https://x402.onchainexpat.com/api/x402-tools/shipping/track
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-multi-carrier-package-tracker-ce891007
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OSE5bSnPm0lpg6rOh3rxq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-multi-carrier-package-tracker-ce891007 -d '<json body>'
```

Example prompt: Can you track my FedEx package with tracking number 274899172985? I want to see its current status and delivery history.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol

## Output

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.

## Example request

```json
{
 "carrier": "fedex",
 "tracking_number": "391629465360"
}
```

## Request schema (JSON Schema)

```json
{
 "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)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-multi-carrier-package-tracker-ce891007/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onchainexpat.com](https://www.zero.xyz/host/x402.onchainexpat.com/llms.txt)