United States Postal Service website screenshot

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.

United States Postal Service publishes 4 APIs on the APIs.io network, including Addresses API, Carrier Pickup API, Domestic Prices API, and 1 more. Tagged areas include Government, Postal Service, Shipping, Logistics, and Address Validation.

The United States Postal Service catalog on APIs.io includes 4 JSON-LD contexts and 2 Spectral governance rulesets.

United States Postal Service’s developer surface includes authentication, developer portal, getting-started guide, documentation, FAQ, support, and 8 more developer resources.

51.1/100 developing ▼ -7.6 Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
12 APIs 8 Features 8 Use Cases
GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 51.1/100 · developing
Contract Quality 17.6 / 25
Developer Ergonomics 8.7 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 3.4 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/united-states-postal-service: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

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.

United States Postal Service Addresses API

Address validation and standardization operations

United States Postal Service Carrier Pickup API

Schedule and manage USPS carrier pickup requests

United States Postal Service Domestic Prices API

Domestic postage pricing and rate calculation operations

United States Postal Service Tracking API

Package tracking status and event operations

Scroll for all 12

Open Collections 4

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

USPS Addresses API

OPEN COLLECTION

USPS Carrier Pickup API

OPEN COLLECTION

USPS Domestic Prices API

OPEN COLLECTION

USPS Tracking API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 8

Notable capabilities this provider offers.

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.

Scroll for all 8

Semantic Vocabularies 4

JSON-LD contexts and semantic vocabularies used across these APIs.

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

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

United States Postal Service API Rules

5 rules · 3 warnings 2 info

SPECTRAL

United States Postal Service API Rules

39 rules · 13 errors 23 warnings 3 info

SPECTRAL

JSON Schema 18

Standalone JSON Schema definitions for this provider's data models.

Address

16 properties

JSON SCHEMA

CityState

3 properties

JSON SCHEMA

ZIPCodeResult

5 properties

JSON SCHEMA

PickupAddress

5 properties

JSON SCHEMA

PickupPackage

2 properties

JSON SCHEMA

PickupRequest

6 properties

JSON SCHEMA

PickupResponse

4 properties

JSON SCHEMA

PickupUpdateRequest

4 properties

JSON SCHEMA

BaseRateRequest

10 properties

JSON SCHEMA

ExtraServiceRateRequest

5 properties

JSON SCHEMA

ExtraServiceRateResponse

1 properties

JSON SCHEMA

RateResponse

1 properties

JSON SCHEMA

TotalRateRequest

8 properties

JSON SCHEMA

TotalRateResponse

1 properties

JSON SCHEMA

MultipleTrackingRequest

1 properties

JSON SCHEMA

MultipleTrackingResult

1 properties

JSON SCHEMA

TrackingEvent

11 properties

JSON SCHEMA

TrackingResult

2 properties

JSON SCHEMA

Scroll for all 18

JSON Structure 18

JSON Structure definitions describing this provider's data shapes.

Addresses Address Structure

16 properties

JSON STRUCTURE

Addresses City State Structure

3 properties

JSON STRUCTURE

Addresses Zip Code Result Structure

5 properties

JSON STRUCTURE

Carrier Pickup Pickup Address Structure

5 properties

JSON STRUCTURE

Carrier Pickup Pickup Package Structure

2 properties

JSON STRUCTURE

Carrier Pickup Pickup Request Structure

6 properties

JSON STRUCTURE

Carrier Pickup Pickup Response Structure

4 properties

JSON STRUCTURE

Domestic Prices Base Rate Request Structure

10 properties

JSON STRUCTURE

Domestic Prices Rate Response Structure

1 properties

JSON STRUCTURE

Tracking Tracking Event Structure

11 properties

JSON STRUCTURE

Tracking Tracking Result Structure

2 properties

JSON STRUCTURE

Scroll for all 18

Examples 18

Example request and response payloads for these APIs.

Addresses Address Example

16 fields

EXAMPLE

Scroll for all 18

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

United States Postal Service Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

United States Postal Service Agentic Access

12 operations · 7 acting

12 operations · 7 acting

AGENTIC

Use Cases 8

What developers build with this provider.

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.

Scroll for all 8

Integrations 6

Pre-built integrations with other platforms and tools.

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.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
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.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/united-states-postal-service.png
url: https://raw.githubusercontent.com/api-evangelist/united-states-postal-service/refs/heads/main/apis.yml
created: 2024/01/01
modified: '2026-05-19'
specificationVersion: '0.19'
tags:
- Government
- Postal Service
- Shipping
- Logistics
- Address Validation
- Package Tracking
apis:
- 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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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-images.s3.amazonaws.com/shared/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
- aid: united-states-postal-service:united-states-postal-service-addresses-api
  name: United States Postal Service Addresses API
  description: Address validation and standardization operations
  humanURL: https://developers.usps.com/addressesv3
  baseURL: https://apis.usps.com
  tags:
  - Addresses
  properties:
  - type: OpenAPI
    url: openapi/united-states-postal-service-addresses-api-openapi.yml
  - type: Documentation
    url: https://developers.usps.com/addressesv3
  - type: JSONSchema
    url: json-schema/addresses-address-schema.json
  - type: JSONSchema
    url: json-schema/addresses-city-state-schema.json
  - type: JSONStructure
    url: json-structure/addresses-address-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-addresses-context.jsonld
  - type: Examples
    url: examples/addresses-address-example.json
  - type: Documentation
    url: https://developers.usps.com/trackingv3r2
  - type: JSONSchema
    url: json-schema/tracking-tracking-event-schema.json
  - type: JSONStructure
    url: json-structure/tracking-tracking-event-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-tracking-context.jsonld
  - type: Examples
    url: examples/tracking-tracking-event-example.json
  - type: Documentation
    url: https://developers.usps.com/domesticpricesv3
  - type: JSONSchema
    url: json-schema/domestic-prices-base-rate-request-schema.json
  - type: JSONStructure
    url: json-structure/domestic-prices-base-rate-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-domestic-context.jsonld
  - type: Examples
    url: examples/domestic-prices-base-rate-request-example.json
  - type: Documentation
    url: https://developers.usps.com/carrierpickupv3
  - type: JSONSchema
    url: json-schema/carrier-pickup-pickup-request-schema.json
  - type: JSONStructure
    url: json-structure/carrier-pickup-pickup-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-carrier-context.jsonld
  - type: Examples
    url: examples/carrier-pickup-pickup-request-example.json
- aid: united-states-postal-service:united-states-postal-service-carrier-pickup-api
  name: United States Postal Service Carrier Pickup API
  description: Schedule and manage USPS carrier pickup requests
  humanURL: https://developers.usps.com/addressesv3
  baseURL: https://apis.usps.com
  tags:
  - Carrier Pickup
  properties:
  - type: OpenAPI
    url: openapi/united-states-postal-service-carrier-pickup-api-openapi.yml
  - type: Documentation
    url: https://developers.usps.com/addressesv3
  - type: JSONSchema
    url: json-schema/addresses-address-schema.json
  - type: JSONSchema
    url: json-schema/addresses-city-state-schema.json
  - type: JSONStructure
    url: json-structure/addresses-address-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-addresses-context.jsonld
  - type: Examples
    url: examples/addresses-address-example.json
  - type: Documentation
    url: https://developers.usps.com/trackingv3r2
  - type: JSONSchema
    url: json-schema/tracking-tracking-event-schema.json
  - type: JSONStructure
    url: json-structure/tracking-tracking-event-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-tracking-context.jsonld
  - type: Examples
    url: examples/tracking-tracking-event-example.json
  - type: Documentation
    url: https://developers.usps.com/domesticpricesv3
  - type: JSONSchema
    url: json-schema/domestic-prices-base-rate-request-schema.json
  - type: JSONStructure
    url: json-structure/domestic-prices-base-rate-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-domestic-context.jsonld
  - type: Examples
    url: examples/domestic-prices-base-rate-request-example.json
  - type: Documentation
    url: https://developers.usps.com/carrierpickupv3
  - type: JSONSchema
    url: json-schema/carrier-pickup-pickup-request-schema.json
  - type: JSONStructure
    url: json-structure/carrier-pickup-pickup-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-carrier-context.jsonld
  - type: Examples
    url: examples/carrier-pickup-pickup-request-example.json
- aid: united-states-postal-service:united-states-postal-service-domestic-prices-api
  name: United States Postal Service Domestic Prices API
  description: Domestic postage pricing and rate calculation operations
  humanURL: https://developers.usps.com/addressesv3
  baseURL: https://apis.usps.com
  tags:
  - Domestic Prices
  properties:
  - type: OpenAPI
    url: openapi/united-states-postal-service-domestic-prices-api-openapi.yml
  - type: Documentation
    url: https://developers.usps.com/addressesv3
  - type: JSONSchema
    url: json-schema/addresses-address-schema.json
  - type: JSONSchema
    url: json-schema/addresses-city-state-schema.json
  - type: JSONStructure
    url: json-structure/addresses-address-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-addresses-context.jsonld
  - type: Examples
    url: examples/addresses-address-example.json
  - type: Documentation
    url: https://developers.usps.com/trackingv3r2
  - type: JSONSchema
    url: json-schema/tracking-tracking-event-schema.json
  - type: JSONStructure
    url: json-structure/tracking-tracking-event-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-tracking-context.jsonld
  - type: Examples
    url: examples/tracking-tracking-event-example.json
  - type: Documentation
    url: https://developers.usps.com/domesticpricesv3
  - type: JSONSchema
    url: json-schema/domestic-prices-base-rate-request-schema.json
  - type: JSONStructure
    url: json-structure/domestic-prices-base-rate-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-domestic-context.jsonld
  - type: Examples
    url: examples/domestic-prices-base-rate-request-example.json
  - type: Documentation
    url: https://developers.usps.com/carrierpickupv3
  - type: JSONSchema
    url: json-schema/carrier-pickup-pickup-request-schema.json
  - type: JSONStructure
    url: json-structure/carrier-pickup-pickup-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-carrier-context.jsonld
  - type: Examples
    url: examples/carrier-pickup-pickup-request-example.json
- aid: united-states-postal-service:united-states-postal-service-tracking-api
  name: United States Postal Service Tracking API
  description: Package tracking status and event operations
  humanURL: https://developers.usps.com/addressesv3
  baseURL: https://apis.usps.com
  tags:
  - Tracking
  properties:
  - type: OpenAPI
    url: openapi/united-states-postal-service-tracking-api-openapi.yml
  - type: Documentation
    url: https://developers.usps.com/addressesv3
  - type: JSONSchema
    url: json-schema/addresses-address-schema.json
  - type: JSONSchema
    url: json-schema/addresses-city-state-schema.json
  - type: JSONStructure
    url: json-structure/addresses-address-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-addresses-context.jsonld
  - type: Examples
    url: examples/addresses-address-example.json
  - type: Documentation
    url: https://developers.usps.com/trackingv3r2
  - type: JSONSchema
    url: json-schema/tracking-tracking-event-schema.json
  - type: JSONStructure
    url: json-structure/tracking-tracking-event-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-tracking-context.jsonld
  - type: Examples
    url: examples/tracking-tracking-event-example.json
  - type: Documentation
    url: https://developers.usps.com/domesticpricesv3
  - type: JSONSchema
    url: json-schema/domestic-prices-base-rate-request-schema.json
  - type: JSONStructure
    url: json-structure/domestic-prices-base-rate-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-domestic-context.jsonld
  - type: Examples
    url: examples/domestic-prices-base-rate-request-example.json
  - type: Documentation
    url: https://developers.usps.com/carrierpickupv3
  - type: JSONSchema
    url: json-schema/carrier-pickup-pickup-request-schema.json
  - type: JSONStructure
    url: json-structure/carrier-pickup-pickup-request-structure.json
  - type: JSONLD
    url: json-ld/united-states-postal-service-carrier-context.jsonld
  - type: Examples
    url: examples/carrier-pickup-pickup-request-example.json
common:
- type: AgenticAccess
  url: agentic-access/united-states-postal-service-agentic-access.yml
- type: DomainSecurity
  url: security/united-states-postal-service-domain-security.yml
- type: Authentication
  url: authentication/united-states-postal-service-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/usps
- 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: Vocabulary
  url: vocabulary/united-states-postal-service-vocabulary.yaml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
aid: united-states-postal-service