United States Postal Service

United States Postal Service Listener URL Specification API

The Listener URL Specification API from United States Postal Service — 1 operation(s) for listener url specification.

GitHub OpenAPI

Operations 1

POST /notifications Notification event in which the API caller should implement #

Documentation

📖
Documentation
https://developers.usps.com/Oauth
📖
Authentication
https://developers.usps.com/getting-started
📖
Documentation
https://developers.usps.com/addressesv3
📖
Documentation
https://developers.usps.com/adjustmentsv3
📖
Documentation
https://developers.usps.com/appointmentsv3
📖
Documentation
https://developers.usps.com/carrierpickupv3
📖
Documentation
https://developers.usps.com/containersv3
📖
Documentation
https://developers.usps.com/domesticlabelsv3
📖
Documentation
https://developers.usps.com/domesticpricesv3
📖
Documentation
https://developers.usps.com/informeddeliverymailcampaignsv3
📖
Documentation
https://developers.usps.com/informeddeliverypackagecampaignsv3
📖
Documentation
https://developers.usps.com/internationallabelsv3-comingsoon
📖
Documentation
https://developers.usps.com/internationalpricesv3
📖
Documentation
https://developers.usps.com/internationalstandardsv3
📖
Documentation
https://developers.usps.com/locationsv3
📖
Documentation
https://developers.usps.com/logistics-shipmentsv3
📖
Documentation
https://developers.usps.com/ncoav3
📖
Documentation
https://developers.usps.com/paymentsv3
📖
Documentation
https://developers.usps.com/pmodv3
📖
Documentation
https://developers.usps.com/qrcodesv3
📖
Documentation
https://developers.usps.com/reconciliationadjustmentsv3
📖
Documentation
https://developers.usps.com/scanv3
📖
Documentation
https://developers.usps.com/service-standards-file-download-v3
📖
Documentation
https://developers.usps.com/servicestandardsdirectoryv3
📖
Documentation
https://developers.usps.com/shipenrollmentv3
📖
Documentation
https://developers.usps.com/shippingoptionsv3
📖
Documentation
https://developers.usps.com/standardsv3
📖
Documentation
https://developers.usps.com/subscriptions-addressesv3
📖
Documentation
https://developers.usps.com/subscriptions-adjustmentsv3
📖
Documentation
https://developers.usps.com/subscriptions-disputesv3
📖
Documentation
https://developers.usps.com/subscriptions-ncoav3
📖
Documentation
https://developers.usps.com/subscriptions-package-transaction-detailsv3
📖
Documentation
https://developers.usps.com/subscriptions-trackingv3
📖
Documentation
https://developers.usps.com/subscriptions-trackingv3r2
📖
Documentation
https://developers.usps.com/subscriptions-unpaid-packagesv3
📖
Documentation
https://developers.usps.com/trackingv3
📖
Documentation
https://developers.usps.com/trackingv3r2
📖
Documentation
https://developers.usps.com/userinfov3

Specifications

⚙
OpenAPI
https://artifacts.apis.io/usps/openapi/usps-listener-url-specification-api-openapi.yml

Schemas & Data

📊
JSONStructure
https://artifacts.apis.io/usps/json-structure/addresses-address-structure.json
📊
JSONStructure
https://artifacts.apis.io/usps/json-structure/carrier-pickup-pickup-request-structure.json
📊
JSONStructure
https://artifacts.apis.io/usps/json-structure/domestic-prices-base-rate-request-structure.json
📊
JSONStructure
https://artifacts.apis.io/usps/json-structure/tracking-tracking-event-structure.json
📊
JSONSchema
https://artifacts.apis.io/usps/json-schema/usps-links-schema.json
📊
JSONSchema
https://artifacts.apis.io/usps/json-schema/usps-adjustment-notification-schema.json

Other Resources

🔗
JSONLD
https://artifacts.apis.io/usps/json-ld/united-states-postal-service-addresses-context.jsonld
🔗
Examples
https://artifacts.apis.io/usps/examples/addresses-address-example.json
🔗
JSONLD
https://artifacts.apis.io/usps/json-ld/united-states-postal-service-carrier-context.jsonld
🔗
Examples
https://artifacts.apis.io/usps/examples/carrier-pickup-pickup-request-example.json
🔗
JSONLD
https://artifacts.apis.io/usps/json-ld/united-states-postal-service-domestic-context.jsonld
🔗
Examples
https://artifacts.apis.io/usps/examples/domestic-prices-base-rate-request-example.json
🔗
JSONLD
https://artifacts.apis.io/usps/json-ld/united-states-postal-service-tracking-context.jsonld
🔗
Examples
https://artifacts.apis.io/usps/examples/tracking-tracking-event-example.json

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/usps:usps-listener-url-specification-api"
All apis 
curl "https://apis.io/api/v1/apis?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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

usps-listener-url-specification-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Usps Listener URL Specification API
  version: '1.0'
  description: 'Operations tagged Listener URL Specification across 9 of this provider''s published API definitions: usps-subscriptions-adjustments-openapi.yml, usps-subscriptions-addresses-openapi.yml, usps-subscriptions-adjustments-openapi.yml, usps-subscriptions-disputes-openapi.yml, usps-subscriptions-ncoa-openapi.yml, usps-subscriptions-package-transaction-details-openapi.yml, usps-subscriptions-tracking-openapi.yml, usps-subscriptions-tracking-v3r2-openapi.yml, usps-subscriptions-unpaid-packages-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://apis.usps.com/subscriptions-adjustments/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-adjustments/v3
  description: Testing Environment Endpoint
- url: https://apis.usps.com/subscriptions-address/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-address/v3
  description: Testing Environment Endpoint
- url: https://apis.usps.com/subscriptions-disputes/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-disputes/v3
  description: Testing Environment Endpoint
- url: https://apis.usps.com/subscriptions-ncoa/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-ncoa/v3
  description: Testing Environment Endpoint
- url: https://apis.usps.com/subscriptions-package-transaction-details/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-package-transaction-details/v3
  description: Testing Environment Endpoint
- url: https://apis.usps.com/subscriptions-tracking/v3
  description: Production Environment Endpoint
- url: https://apis.usps.com/subscriptions-tracking/v3r2
  description: Production Environment Endpoint
- url: https://apis.usps.com/subscriptions-unpaid-packages/v3
  description: Production Environment Endpoint
- url: https://apis-tem.usps.com/subscriptions-unpaid-packages/v3
  description: Testing Environment Endpoint
tags:


# --- truncated at 32 KB (65 KB total) ---
# Full source: https://artifacts.apis.io/usps/openapi/usps-listener-url-specification-api-openapi.yml