United States Postal Service · Schema
ServiceStandardsResponse
GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking
Properties
| Name | Type | Description |
|---|---|---|
| metadata | object | Metadata containing information for pagination |
| publishDate | string | Publish date of data (YYYY-MM-DD) |
| effectiveDate | string | Effective date of data (YYYY-MM-DD) |
| standards | array | service standards |
| messages | array | Extra information provided to provide context to the response. |
| unsupportedZIPCodes | array | List of all unsupported ZIP codes provided in the `originZIPCode` and `destinationZIPCode` parameters. |
| exemptOriginZIPCodes | array | List of all exempt origin ZIP codes provided in the `originZIPCode` parameter. ZIP codes can be exempt on origin, destination, or both. |
| exemptDestinationZIPCodes | array | List of all exempt destination ZIP codes provided in the `destinationZIPCode` parameter. ZIP codes can be exempt on origin, destination, or both. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/usps/json-schema/usps-service-standards-response-schema.json",
"title": "ServiceStandardsResponse",
"x-generated": "2026-11-11",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/usps-service-standards-directory-openapi.yml#/components/schemas/ServiceStandardsResponse",
"type": "object",
"properties": {
"metadata": {
"type": "object",
"description": "Metadata containing information for pagination",
"properties": {
"totalCount": {
"type": "number",
"description": "Total number of service standard objects to be returned in the API request (sum of all paginated results).",
"minimum": 0
},
"page": {
"type": "number",
"description": "The current page number.",
"minimum": 0
},
"totalPages": {
"type": "number",
"description": "Total number of pages, based on the user provided limit and totalCount.",
"minimum": 0
},
"offset": {
"type": "number",
"description": "The number of service standard objects to skip before returning the results. Based on the user provided offset.",
"minimum": 0
},
"limit": {
"type": "number",
"description": "The number of service standard objects to return. Based on the user provided limit.",
"minimum": 1,
"maximum": 20000
},
"links": {
"type": "object",
"description": "Pagination navigation links.",
"properties": {
"self": {
"type": "object",
"description": "Link to the current page of results.",
"properties": {
"href": {
"type": "string",
"format": "uri",
"description": "Endpoint URL (always /reporter)"
},
"method": {
"type": "string",
"enum": [
"POST"
],
"description": "HTTP method to use (POST)"
},
"body": {
"type": "object",
"description": "Request body for this page"
}
}
},
"next": {
"type": [
"object",
"null"
],
"description": "Link to the next page of results.",
"properties": {
"href": {
"type": "string",
"description": "Endpoint URL (always /reporter)",
"format": "uri"
},
"method": {
"type": "string",
"enum": [
"POST"
],
"description": "HTTP method to use (POST)"
},
"body": {
"type": "object",
"description": "Request body for this page"
}
}
},
"previous": {
"type": [
"object",
"null"
],
"description": "Link to the previous page of results.",
"properties": {
"href": {
"type": "string",
"description": "Endpoint URL (always /reporter)",
"format": "uri"
},
"method": {
"type": "string",
"enum": [
"POST"
],
"description": "HTTP method to use (POST)"
},
"body": {
"type": "object",
"description": "Request body for this page"
}
}
},
"first": {
"type": [
"object",
"null"
],
"description": "Link to the first page of results.",
"properties": {
"href": {
"type": "string",
"description": "Endpoint URL (always /reporter)",
"format": "uri"
},
"method": {
"type": "string",
"enum": [
"POST"
],
"description": "HTTP method to use (POST)"
},
"body": {
"type": "object",
"description": "Request body for this page"
}
}
},
"last": {
"type": [
"object",
"null"
],
"description": "Link to the last page of results.",
"properties": {
"href": {
"type": "string",
"description": "Endpoint URL (always /reporter)",
"format": "uri"
},
"method": {
"type": "string",
"enum": [
"POST"
],
"description": "HTTP method to use (POST)"
},
"body": {
"type": "object",
"description": "Request body for this page"
}
}
}
}
}
}
},
"publishDate": {
"type": "string",
"format": "date",
"description": "Publish date of data (YYYY-MM-DD)"
},
"effectiveDate": {
"type": "string",
"format": "date",
"description": "Effective date of data (YYYY-MM-DD)"
},
"standards": {
"type": "array",
"description": "service standards",
"items": {
"type": "object",
"description": "List of service standards",
"properties": {
"originZIPCode": {
"type": "string",
"pattern": "^\\d{3}$|^\\d{5}$",
"description": "Origin ZIP Code"
},
"destinationZIPCode": {
"type": "string",
"pattern": "^\\d{3}$|^\\d{5}$",
"description": "Destination ZIP Code"
},
"FCMSvcStd": {
"type": "number",
"description": "First-Class Mail Single Piece Service Standard"
},
"GAHSvcStd": {
"type": "number",
"description": "Ground Advantage Heavyweight >= 16oz Service Standard"
},
"GALSvcStd": {
"type": "number",
"description": "Ground Advantage Lightweight <= 15.999oz"
},
"MktSvcStd": {
"type": "number",
"description": "Marketing Mail Service Standard"
},
"PerSvcStd": {
"type": "number",
"description": "Periodicals Service Standard"
},
"PkgSvcStd": {
"type": "number",
"description": "Package Services Service Standard"
},
"PriSvcStd": {
"type": "number",
"description": "Priority Mail Service Standard"
},
"PFCSvcStd": {
"type": "number",
"description": "Presort First-Class Mail Service Standard"
}
}
}
},
"messages": {
"type": "array",
"description": "Extra information provided to provide context to the response.",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Text code describing the response information."
},
"detail": {
"type": "string",
"description": "Detailed text describing the response information."
}
}
}
},
"unsupportedZIPCodes": {
"type": "array",
"description": "List of all unsupported ZIP codes provided in the `originZIPCode` and `destinationZIPCode` parameters.",
"items": {
"type": "string",
"pattern": "^\\d{3}$|^\\d{5}$"
}
},
"exemptOriginZIPCodes": {
"type": "array",
"description": "List of all exempt origin ZIP codes provided in the `originZIPCode` parameter. ZIP codes can be exempt on origin, destination, or both.",
"items": {
"type": "string",
"pattern": "^\\d{3}$|^\\d{5}$"
}
},
"exemptDestinationZIPCodes": {
"type": "array",
"description": "List of all exempt destination ZIP codes provided in the `destinationZIPCode` parameter. ZIP codes can be exempt on origin, destination, or both.",
"items": {
"type": "string",
"pattern": "^\\d{3}$|^\\d{5}$"
}
}
}
}
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/usps-service-standards-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.