United States Postal Service · Schema
TrackingEvent
A single tracking scan event for a package.
GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking
Properties
| Name | Type | Description |
|---|---|---|
| EventTime | string | Time of the tracking event. |
| EventDate | string | Date of the tracking event. |
| Event | string | Description of the tracking event. |
| EventCity | string | City where the event occurred. |
| EventState | string | State where the event occurred. |
| EventZIPCode | string | ZIP Code of the event location. |
| EventCountry | string | Country where the event occurred (empty for domestic). |
| FirmName | string | Company name for business deliveries. |
| Name | string | Recipient name if available. |
| AuthorizedAgent | string | Whether delivered to an authorized agent. |
| DeliveryAttributeCode | string | Code indicating delivery type or condition. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/united-states-postal-service/refs/heads/main/json-schema/tracking-tracking-event-schema.json",
"title": "TrackingEvent",
"description": "A single tracking scan event for a package.",
"type": "object",
"properties": {
"EventTime": {
"type": "string",
"description": "Time of the tracking event.",
"example": "8:00 am"
},
"EventDate": {
"type": "string",
"description": "Date of the tracking event.",
"example": "March 14, 2025"
},
"Event": {
"type": "string",
"description": "Description of the tracking event.",
"example": "DELIVERED"
},
"EventCity": {
"type": "string",
"description": "City where the event occurred.",
"example": "WASHINGTON"
},
"EventState": {
"type": "string",
"description": "State where the event occurred.",
"example": "DC"
},
"EventZIPCode": {
"type": "string",
"description": "ZIP Code of the event location.",
"example": "20212"
},
"EventCountry": {
"type": "string",
"description": "Country where the event occurred (empty for domestic).",
"example": ""
},
"FirmName": {
"type": "string",
"description": "Company name for business deliveries.",
"example": ""
},
"Name": {
"type": "string",
"description": "Recipient name if available.",
"example": "JOHN DOE"
},
"AuthorizedAgent": {
"type": "string",
"description": "Whether delivered to an authorized agent.",
"example": "false"
},
"DeliveryAttributeCode": {
"type": "string",
"description": "Code indicating delivery type or condition.",
"example": "01"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/tracking-tracking-event"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.