UPS website screenshot

UPS

UPS, or United Parcel Service, is a Fortune 500 global logistics company that specializes in package delivery and supply chain management services. UPS provides a comprehensive REST API platform with OAuth 2.0 authentication covering shipping, tracking, rating, address validation, pickup scheduling, paperless international documents, and time-in-transit estimation.

UPS publishes 8 APIs on the APIs.io network, including Address Validation API, OAuth API, Paperless Documents API, and 5 more. Tagged areas include Logistics, Shipping, Fortune 500, and Supply Chain.

The UPS catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

UPS’s developer surface includes authentication, getting-started guide, and 7 more developer resources.

46.0/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessEnterpriseSelf serve
8 APIs 3 Features
LogisticsShippingFortune 500Supply Chain

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 46.0/100 · developing
Contract Quality 17.9 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 2.7 / 13
Governance 7.0 / 12
Discoverability 6.5 / 10
Agent readiness — 31/100 · agent aware
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 0 / 8
Request/Response Examples 0 / 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/ups: 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 8

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

UPS Address Validation API

Address validation and standardization

UPS OAuth API

OAuth 2.0 token management

UPS Paperless Documents API

International paperless document management

UPS Pickup API

Pickup scheduling and management

UPS Rating API

Shipping rates and service comparison

UPS Shipping API

Shipment creation and label generation

UPS Time In Transit API

Transit time and service schedules

UPS Tracking API

Package tracking and status

Scroll for all 8

Open Collections 1

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

UPS Shipping API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

UPS GraphQL Schema

This GraphQL schema represents the UPS Developer Kit REST API surface — covering shipping, tracking, rating, address validation, pickup scheduling, and related logistics operati...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Ups Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Ups Rate Limits

1 limits

RATE LIMITS

FinOps 1

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

Ups Finops

FINOPS

Features 3

Notable capabilities this provider offers.

UPS: API access via partner / B2B contracts only
No public API pricing published — contact enterprise sales
UPS Developer Kit APIs (Shipping, Tracking, Rating, Address Validation) require account; shipping rates per package/zone.

Semantic Vocabularies 1

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

Ups Context

4 classes · 17 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

UPS API Rules

5 rules · 3 warnings 2 info

SPECTRAL

UPS API Rules

6 rules · 3 warnings 3 info

SPECTRAL

JSON Schema 22

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

Address

6 properties

JSON SCHEMA

AddressValidationRequest

1 properties

JSON SCHEMA

AddressValidationResponse

1 properties

JSON SCHEMA

CancelPickupResponse

1 properties

JSON SCHEMA

ErrorResponse

1 properties

JSON SCHEMA

OAuthTokenResponse

6 properties

JSON SCHEMA

PackageInfo

3 properties

JSON SCHEMA

PaperlessDocumentRequest

1 properties

JSON SCHEMA

PaperlessDocumentResponse

1 properties

JSON SCHEMA

PickupRequest

1 properties

JSON SCHEMA

PickupResponse

1 properties

JSON SCHEMA

RateRequest

1 properties

JSON SCHEMA

RateResponse

1 properties

JSON SCHEMA

ServiceCode

2 properties

JSON SCHEMA

UPS Shipment

7 properties

JSON SCHEMA

ShipmentRequest

1 properties

JSON SCHEMA

ShipmentResponse

1 properties

JSON SCHEMA

ShipperInfo

5 properties

JSON SCHEMA

TimeInTransitRequest

13 properties

JSON SCHEMA

TimeInTransitResponse

3 properties

JSON SCHEMA

TrackResponse

1 properties

JSON SCHEMA

VoidResponse

1 properties

JSON SCHEMA

Scroll for all 22

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Ups Shipment Structure

0 properties

JSON STRUCTURE

Ups Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Ups Shop Rates Example

2 fields

EXAMPLE

Security Posture 2

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

Ups Authentication

http/oauth2 · 2 schemes

SECURITY

Ups Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Ups Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

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

Ups Agentic Access

11 operations · 10 acting

11 operations · 10 acting

AGENTIC

Press 5

Recent news and press coverage referencing this provider.

The Brilliant Ways UPS Uses Artificial Intelligence ...

2026-05-25

UPS Uses Artificial Intelligence For Pricing

2026-05-25

UPS is improving careers and access to opportunity with ...

2026-05-25

UPS is teaming up with artificial intelligence to try and ...

2026-05-25

How UPS is using AI, from shipper pricing to customs ...

2026-05-25

Resources

Get Started 2

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Access & Security 3

Authentication, authorization, and security posture

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: ups
url: https://raw.githubusercontent.com/api-evangelist/ups/refs/heads/main/apis.yml
apis:
- aid: ups:ups-address-validation-api
  name: UPS Address Validation API
  description: Address validation and standardization
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Address Validation
  properties:
  - type: OpenAPI
    url: openapi/ups-address-validation-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-oauth-api
  name: UPS OAuth API
  description: OAuth 2.0 token management
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - OAuth
  properties:
  - type: OpenAPI
    url: openapi/ups-oauth-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-paperless-documents-api
  name: UPS Paperless Documents API
  description: International paperless document management
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Paperless Documents
  properties:
  - type: OpenAPI
    url: openapi/ups-paperless-documents-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-pickup-api
  name: UPS Pickup API
  description: Pickup scheduling and management
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Pickup
  properties:
  - type: OpenAPI
    url: openapi/ups-pickup-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-rating-api
  name: UPS Rating API
  description: Shipping rates and service comparison
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Rating
  properties:
  - type: OpenAPI
    url: openapi/ups-rating-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-shipping-api
  name: UPS Shipping API
  description: Shipment creation and label generation
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Shipping
  properties:
  - type: OpenAPI
    url: openapi/ups-shipping-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-time-in-transit-api
  name: UPS Time In Transit API
  description: Transit time and service schedules
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Time In Transit
  properties:
  - type: OpenAPI
    url: openapi/ups-time-in-transit-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
- aid: ups:ups-tracking-api
  name: UPS Tracking API
  description: Package tracking and status
  humanURL: https://developer.ups.com/
  baseURL: https://onlinetools.ups.com/api
  tags:
  - Tracking
  properties:
  - type: OpenAPI
    url: openapi/ups-tracking-api-openapi.yml
  - type: Documentation
    url: https://developer.ups.com/
  - type: GettingStarted
    url: https://developer.ups.com/get-started
  - type: GraphQL
    url: graphql/ups-graphql.md
name: UPS
tags:
- Logistics
- Shipping
- Fortune 500
- Supply Chain
type: Index
accessModel:
  pricing: enterprise
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Enterprise · 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/ups.png
access: 3rd-Party
created: '2025-03-01'
modified: '2026-05-19'
position: Consumer
description: UPS, or United Parcel Service, is a Fortune 500 global logistics company that specializes in package delivery
  and supply chain management services. UPS provides a comprehensive REST API platform with OAuth 2.0 authentication covering
  shipping, tracking, rating, address validation, pickup scheduling, paperless international documents, and time-in-transit
  estimation.
common:
- type: AgenticAccess
  url: agentic-access/ups-agentic-access.yml
- type: DomainSecurity
  url: security/ups-domain-security.yml
- type: Authentication
  url: authentication/ups-authentication.yml
- type: OAuthScopes
  url: scopes/ups-scopes.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/ups
- type: Website
  url: https://www.ups.com
- type: DeveloperPortal
  url: https://developer.ups.com
- type: API Catalog
  url: https://developer.ups.com/catalog
- type: GettingStarted
  url: https://developer.ups.com/get-started
- type: Features
  data:
  - 'UPS: API access via partner / B2B contracts only'
  - No public API pricing published — contact enterprise sales
  - UPS Developer Kit APIs (Shipping, Tracking, Rating, Address Validation) require account; shipping rates per package/zone.
  sources:
  - https://developer.ups.com/
  updated: '2026-05-04'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.19'