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: Faire
providerId: faire
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: false
tags:
- Marketplace
- Wholesale
- Retail
- Ecommerce
- Rate Limiting
- Quotas
- Throttling
description: Faire External API v2 enforces per-token rate limits and returns HTTP 429 with Retry-After
  when exceeded. Specific RPS thresholds are not openly published.
notes: Use pagination and webhooks to reduce polling.
sources:
- https://developers.faire.com/docs
responseCodes:
  throttled: 429
limits:
- name: Default External API
  scope: token
  metric: requests
  limit: not publicly documented
  notes: Honor 429 and Retry-After.
policies:
- name: Backoff Strategy
  description: Clients should implement exponential backoff with jitter and honor any Retry-After header.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com