name: United States Postal Service description: >- The United States Postal Service (USPS) provides a modern REST API platform at developers.usps.com that gives ecommerce websites, shipping software, and logistics systems access to postal data and services. APIs cover address validation, package tracking, domestic and international shipping labels, pricing, carrier pickup scheduling, location finding, and Informed Delivery campaign management. The legacy Web Tools platform was retired January 25, 2026, with all functionality migrated to the new OAuth 2.0-secured API platform. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg url: https://raw.githubusercontent.com/api-evangelist/united-states-postal-service/refs/heads/main/apis.yml created: '2024/01/01' modified: '2026-05-03' specificationVersion: '0.19' tags: - Government - Postal Service - Shipping - Logistics - Address Validation - Package Tracking apis: - name: USPS Addresses API description: >- Validates and corrects address information to USPS specifications, eliminating errors and improving package delivery. Supports full address standardization, city and state lookup by ZIP Code, and ZIP Code lookup by address. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/addressesv3 baseURL: https://apis.usps.com tags: - Addresses - Address Validation - Government properties: - type: Documentation url: https://developers.usps.com/addressesv3 - type: OpenAPI url: openapi/united-states-postal-service-addresses-openapi.yml - type: JSONSchema url: json-schema/addresses-address-schema.json title: Address Schema - type: JSONSchema url: json-schema/addresses-city-state-schema.json title: City State Schema - type: JSONStructure url: json-structure/addresses-address-structure.json title: Address Structure - type: JSON-LD url: json-ld/united-states-postal-service-addresses-context.jsonld - type: Example url: examples/addresses-address-example.json title: Address Example aid: united-states-postal-service:usps-addresses-api - name: USPS Tracking API description: >- Returns tracking status and related details for a given USPS package, including scan events with date, time, and location. Supports single and batch package tracking. Version 3.2 includes enhanced scan event extract notifications. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/trackingv3r2 baseURL: https://apis.usps.com tags: - Tracking - Package Tracking - Government properties: - type: Documentation url: https://developers.usps.com/trackingv3r2 - type: OpenAPI url: openapi/united-states-postal-service-tracking-openapi.yml - type: JSONSchema url: json-schema/tracking-tracking-event-schema.json title: Tracking Event Schema - type: JSONStructure url: json-structure/tracking-tracking-event-structure.json title: Tracking Event Structure - type: JSON-LD url: json-ld/united-states-postal-service-tracking-context.jsonld - type: Example url: examples/tracking-tracking-event-example.json title: Tracking Event Example aid: united-states-postal-service:usps-tracking-api - name: USPS Domestic Prices API description: >- Provides postage pricing for domestic USPS shipments based on origin and destination ZIP Codes, weight, dimensions, and mail class. Supports base rate lookups, extra service rates (insurance, signature confirmation, etc.), and total rate calculations. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/domesticpricesv3 baseURL: https://apis.usps.com tags: - Pricing - Postage - Shipping - Government properties: - type: Documentation url: https://developers.usps.com/domesticpricesv3 - type: OpenAPI url: openapi/united-states-postal-service-domestic-prices-openapi.yml - type: JSONSchema url: json-schema/domestic-prices-base-rate-request-schema.json title: Base Rate Request Schema - type: JSONStructure url: json-structure/domestic-prices-base-rate-request-structure.json title: Base Rate Request Structure - type: JSON-LD url: json-ld/united-states-postal-service-domestic-context.jsonld - type: Example url: examples/domestic-prices-base-rate-request-example.json title: Base Rate Request Example aid: united-states-postal-service:usps-domestic-prices-api - name: USPS Carrier Pickup API description: >- Enables free carrier pickup scheduling for next-day service, Monday through Saturday, excluding federal holidays. Supports creating, retrieving, updating, and canceling pickup requests at residential and commercial addresses. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/carrierpickupv3 baseURL: https://apis.usps.com tags: - Carrier Pickup - Shipping - Government properties: - type: Documentation url: https://developers.usps.com/carrierpickupv3 - type: OpenAPI url: openapi/united-states-postal-service-carrier-pickup-openapi.yml - type: JSONSchema url: json-schema/carrier-pickup-pickup-request-schema.json title: Pickup Request Schema - type: JSONStructure url: json-structure/carrier-pickup-pickup-request-structure.json title: Pickup Request Structure - type: JSON-LD url: json-ld/united-states-postal-service-carrier-context.jsonld - type: Example url: examples/carrier-pickup-pickup-request-example.json title: Pickup Request Example aid: united-states-postal-service:usps-carrier-pickup-api - name: USPS International Prices API description: >- Provides pricing for international USPS products based on shipment characteristics including destination country, weight, dimensions, and service class. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/internationalpricesv3 baseURL: https://apis.usps.com tags: - International - Pricing - Postage - Government properties: - type: Documentation url: https://developers.usps.com/internationalpricesv3 aid: united-states-postal-service:usps-international-prices-api - name: USPS Domestic Labels API description: >- Creates domestic shipping labels with barcodes in multiple formats and generates Shipping Services Files. Requires USPS Ship enrollment and Enterprise Payment Account. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/domesticlabelsv3 baseURL: https://apis.usps.com tags: - Labels - Shipping - Government properties: - type: Documentation url: https://developers.usps.com/domesticlabelsv3 aid: united-states-postal-service:usps-domestic-labels-api - name: USPS International Labels API description: >- Creates international shipping labels and generates required Shipping Services Files for customs compliance. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/internationallabelsv3 baseURL: https://apis.usps.com tags: - International - Labels - Shipping - Government properties: - type: Documentation url: https://developers.usps.com/internationallabelsv3 aid: united-states-postal-service:usps-international-labels-api - name: USPS Locations API description: >- Identifies drop-off facilities and destination entry points for various USPS services. Supports post office locator and drop-off location finder. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/locationsv3 baseURL: https://apis.usps.com tags: - Locations - Post Offices - Government properties: - type: Documentation url: https://developers.usps.com/locationsv3 aid: united-states-postal-service:usps-locations-api - name: USPS Service Standards API description: >- Provides delivery benchmarks showing expected transit times between origin and destination ZIP Codes for USPS mail classes. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/standardsv3 baseURL: https://apis.usps.com tags: - Service Standards - Delivery - Government properties: - type: Documentation url: https://developers.usps.com/standardsv3 aid: united-states-postal-service:usps-service-standards-api - name: USPS Shipping Options API description: >- Returns a comprehensive list of pricing, service standards, and shipping options for USPS products in a single API call, eliminating the need to query multiple APIs separately. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/shippingoptionsv3 baseURL: https://apis.usps.com tags: - Shipping - Pricing - Government properties: - type: Documentation url: https://developers.usps.com/shippingoptionsv3 aid: united-states-postal-service:usps-shipping-options-api - name: USPS SCAN Forms API description: >- Links multiple domestic and international labels through a single electronic file number, creating Shipment Confirmation Acceptance Notice forms for batch shipping operations. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/scanv3 baseURL: https://apis.usps.com tags: - SCAN Forms - Shipping - Government properties: - type: Documentation url: https://developers.usps.com/scanv3 aid: united-states-postal-service:usps-scan-forms-api - name: USPS OAuth API description: >- Industry-standard OAuth 2.0 Client Credentials authentication protecting access to all USPS APIs. Returns Bearer Tokens used in the Authorization header for all USPS API calls. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developers.usps.com/Oauth baseURL: https://apis.usps.com tags: - Authentication - OAuth - Government properties: - type: Documentation url: https://developers.usps.com/Oauth - type: Authentication url: https://developers.usps.com/getting-started aid: united-states-postal-service:usps-oauth-api common: - type: Portal url: https://developers.usps.com/ - type: GettingStarted url: https://developers.usps.com/getting-started - type: Documentation url: https://developers.usps.com/apis - type: TermsOfService url: https://developers.usps.com/terms-and-conditions - type: FAQ url: https://developers.usps.com/faq - type: Support url: https://emailus.usps.com/s/web-tools-inquiry - type: GitHubOrganization url: https://github.com/USPS - type: GitHubRepository url: https://github.com/USPS/api-examples - type: Features data: - name: OAuth 2.0 Authentication description: Secure API access using industry-standard OAuth 2.0 Client Credentials flow with Bearer Token authentication. - name: RESTful Architecture description: All APIs follow RESTful conventions with JSON request and response bodies. - name: Sandbox Testing Environment description: Testing Environment for Mailers (TEM) at apis-tem.usps.com for safe API testing before going to production. - name: Address Standardization description: USPS Coding Accuracy Support System (CASS) compliant address validation and standardization. - name: Delivery Point Validation description: DPV confirmation codes ensure packages can be delivered to the validated address. - name: Real-Time Tracking description: Live package tracking with scan events, timestamps, and location details from USPS systems. - name: Webhook Subscriptions description: Event-driven subscription APIs for tracking events, adjustments, and disputes delivered via webhooks. - name: Batch Processing description: Support for bulk operations including multiple tracking lookups and SCAN Form generation. - type: UseCases data: - name: E-Commerce Shipping Integration description: Calculate shipping rates, generate labels, and provide package tracking directly within e-commerce checkout flows. - name: Address Verification at Checkout description: Validate and standardize customer addresses during checkout to reduce failed deliveries and return rates. - name: Shipping Label Generation description: Programmatically create domestic and international USPS shipping labels with barcodes for fulfillment operations. - name: Carrier Pickup Automation description: Schedule and manage USPS carrier pickups automatically based on order fulfillment triggers. - name: Logistics Rate Shopping description: Compare USPS service options and pricing to select the most cost-effective shipping method. - name: Delivery Time Estimation description: Display accurate expected delivery dates to customers using USPS service standards data. - name: Post Office Finder description: Help customers locate the nearest USPS facility for drop-offs or in-person services. - name: Informed Delivery Campaigns description: Enhance customer engagement by adding digital content to mail pieces viewed through Informed Delivery. - type: Integrations data: - name: Shopify description: USPS shipping integration available through Shopify Shipping for label generation and rate calculation. - name: WooCommerce description: WooCommerce shipping plugins integrate USPS APIs for rate calculation and label printing. - name: Magento description: Adobe Commerce and Magento integrate USPS for shipping rate display and fulfillment. - name: ShipStation description: ShipStation multi-carrier shipping platform integrates USPS APIs for ecommerce fulfillment. - name: EasyPost description: EasyPost shipping API aggregator provides access to USPS services alongside other carriers. - name: Stamps.com description: Stamps.com and Pitney Bowes shipping platforms integrate USPS APIs for postage and label printing. - type: SpectralRules url: rules/united-states-postal-service-spectral-rules.yml - type: NaftikoCapability url: capabilities/ecommerce-shipping.yaml title: E-Commerce Shipping - type: NaftikoCapability url: capabilities/package-tracking.yaml title: Package Tracking - type: Vocabulary url: vocabulary/united-states-postal-service-vocabulary.yaml maintainers: - FN: Kin Lane email: kin@apievangelist.com aid: united-states-postal-service