United States Postal Service

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.

12 APIs 8 Features

GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking

APIs

USPS Addresses API

Validates and corrects address information to USPS specifications, eliminating errors and improving package delivery. Supports full address standardization, city and state looku...

USPS Tracking API

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....

USPS Domestic Prices API

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 rat...

USPS Carrier Pickup API

Enables free carrier pickup scheduling for next-day service, Monday through Saturday, excluding federal holidays. Supports creating, retrieving, updating, and canceling pickup r...

USPS International Prices API

Provides pricing for international USPS products based on shipment characteristics including destination country, weight, dimensions, and service class.

USPS Domestic Labels API

Creates domestic shipping labels with barcodes in multiple formats and generates Shipping Services Files. Requires USPS Ship enrollment and Enterprise Payment Account.

USPS International Labels API

Creates international shipping labels and generates required Shipping Services Files for customs compliance.

USPS Locations API

Identifies drop-off facilities and destination entry points for various USPS services. Supports post office locator and drop-off location finder.

USPS Service Standards API

Provides delivery benchmarks showing expected transit times between origin and destination ZIP Codes for USPS mail classes.

USPS Shipping Options API

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.

USPS SCAN Forms API

Links multiple domestic and international labels through a single electronic file number, creating Shipment Confirmation Acceptance Notice forms for batch shipping operations.

USPS OAuth API

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.

Collections

USPS Addresses API

OPEN

USPS Carrier Pickup API

OPEN

USPS Domestic Prices API

OPEN

USPS Tracking API

OPEN

Pricing Plans

United States Postal Service Plans Pricing

2 plans

PLANS

Rate Limits

United States Postal Service Rate Limits

2 limits

RATE LIMITS

FinOps

United States Postal Service Finops

FINOPS

Features

OAuth 2.0 Authentication

Secure API access using industry-standard OAuth 2.0 Client Credentials flow with Bearer Token authentication.

RESTful Architecture

All APIs follow RESTful conventions with JSON request and response bodies.

Sandbox Testing Environment

Testing Environment for Mailers (TEM) at apis-tem.usps.com for safe API testing before going to production.

Address Standardization

USPS Coding Accuracy Support System (CASS) compliant address validation and standardization.

Delivery Point Validation

DPV confirmation codes ensure packages can be delivered to the validated address.

Real-Time Tracking

Live package tracking with scan events, timestamps, and location details from USPS systems.

Webhook Subscriptions

Event-driven subscription APIs for tracking events, adjustments, and disputes delivered via webhooks.

Batch Processing

Support for bulk operations including multiple tracking lookups and SCAN Form generation.

Use Cases

E-Commerce Shipping Integration

Calculate shipping rates, generate labels, and provide package tracking directly within e-commerce checkout flows.

Address Verification at Checkout

Validate and standardize customer addresses during checkout to reduce failed deliveries and return rates.

Shipping Label Generation

Programmatically create domestic and international USPS shipping labels with barcodes for fulfillment operations.

Carrier Pickup Automation

Schedule and manage USPS carrier pickups automatically based on order fulfillment triggers.

Logistics Rate Shopping

Compare USPS service options and pricing to select the most cost-effective shipping method.

Delivery Time Estimation

Display accurate expected delivery dates to customers using USPS service standards data.

Post Office Finder

Help customers locate the nearest USPS facility for drop-offs or in-person services.

Informed Delivery Campaigns

Enhance customer engagement by adding digital content to mail pieces viewed through Informed Delivery.

Integrations

Shopify

USPS shipping integration available through Shopify Shipping for label generation and rate calculation.

WooCommerce

WooCommerce shipping plugins integrate USPS APIs for rate calculation and label printing.

Magento

Adobe Commerce and Magento integrate USPS for shipping rate display and fulfillment.

ShipStation

ShipStation multi-carrier shipping platform integrates USPS APIs for ecommerce fulfillment.

EasyPost

EasyPost shipping API aggregator provides access to USPS services alongside other carriers.

Stamps.com

Stamps.com and Pitney Bowes shipping platforms integrate USPS APIs for postage and label printing.

Semantic Vocabularies

United States Postal Service Addresses Context

3 classes · 16 properties

JSON-LD

United States Postal Service Carrier Context

5 classes · 17 properties

JSON-LD

United States Postal Service Domestic Context

8 classes · 19 properties

JSON-LD

United States Postal Service Tracking Context

4 classes · 18 properties

JSON-LD

API Governance Rules

United States Postal Service API Rules

33 rules · 13 errors 19 warnings 1 info

2 properties

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: USPS Tracking API
  version: '3.2'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Tracking
    type: folder
  items:
  - info:
      name: USPS Tracking Get Package Tracking Status
      type: http
    http:
      method: GET
      url: https://apis.usps.com/tracking/v3/tracking/:trackingNumber
      params:
      - name: trackingNumber
        value: '9400111899223397910390'
        type: path
        description: The USPS tracking number for the package.
      - name: expand
        value: SUMMARY
        type: query
        description: Optional expansion for additional detail fields (e.g. SUMMARY).
    docs: Returns the tracking status and complete scan event history for a given USPS tracking number. Includes delivery
      status, estimated delivery date, and location details for each scan event.
  - info:
      name: USPS Tracking Get Multiple Package Tracking Status
      type: http
    http:
      method: POST
      url: https://apis.usps.com/tracking/v3/tracking
      body:
        type: json
        data: '{}'
    docs: Returns tracking status for multiple USPS packages in a single request. Accepts up to 10 tracking numbers per request.
bundled: true