specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: EasyPost
providerId: easypost
created: '2026-05-08'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-08, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-08'
reconciled: true
tags:
- Shipping
- Logistics
- Multi-Carrier
- Tracking
- Labels
- Insurance
- Rate Limiting
- Quotas
- Throttling
description: >-
  EasyPost applies per-account rate limits and returns HTTP 429 with Retry-After when exceeded.
  Default sustained throughput is in the tens of requests per second per account; bursting beyond your
  account profile triggers throttling. Higher limits are available on request and via enterprise
  contracts.
notes: Per-account; baseline tens of RPS; higher on request.
sources:
- https://docs.easypost.com/docs/rate-limits
responseCodes:
  throttled: 429
limits:
- name: Per account (sustained)
  scope: account
  metric: requests-per-second
  limit: tens of RPS (account-defined)
  notes: Throttled with 429; use bulk endpoints when available.
- name: Burst
  scope: account
  metric: burst
  limit: account-defined
  notes: Sustained burst beyond profile triggers 429.
policies:
- name: Backoff Strategy
  description: Honor 429/Retry-After with exponential backoff and jitter.
- name: Batch Operations
  description: Use Batch endpoints for high-volume label creation to reduce per-call overhead.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com