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: Choreo
providerId: choreo
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-05'
reconciled: false
tags:
  - API Management
  - Cloud Native
  - Platform Engineering
  - Rate Limiting
description: Choreo applies plan-level monthly request quotas (2M on Developer, up to 5M on Team,
  unlimited on Enterprise) at the platform edge. In addition, customers configure per-API rate-limit
  policies through Choreo API Management — these are user-defined throttling tiers (Bronze / Silver
  / Gold or custom) attached to individual APIs and subscriptions, not global platform numbers. WSO2
  does not publish a single per-second platform throttle; the practical RPS depends on the policy
  attached to each API and the underlying gateway sizing.
notes: Choreo does not publish a single per-second/per-minute platform-wide rate-limit number. Limits
  are split between (a) the published monthly request quotas in the pricing page (captured here) and
  (b) per-API throttling policies that customers configure inside Choreo API Management.
sources:
  - https://wso2.com/choreo/pricing/
  - https://wso2.com/choreo/docs/
responseCodes:
  throttled: 429
  quotaExceeded: 429
  serverError: 500
  serviceUnavailable: 503
limits:
  - name: Developer plan monthly request cap
    scope: organization
    metric: requests_per_month
    limit: 2000000
    timeFrame: month
    notes: Hard cap on the free tier; further requests are throttled until the next billing cycle.
  - name: Team plan monthly request cap
    scope: organization
    metric: requests_per_month
    limit: 5000000
    timeFrame: month
    notes: Maximum included in the Team plan; pass-through pricing once exceeded.
  - name: Enterprise plan
    scope: organization
    metric: requests_per_month
    limit: -1
    timeFrame: month
    notes: Unlimited on Enterprise — bounded by the customer's negotiated infrastructure footprint.
  - name: Per-API throttling policy
    scope: api/subscription
    metric: varies
    limit: 'configurable per-API throttling tier (Bronze / Silver / Gold or custom)'
    notes: Customers attach throttle policies to APIs and subscriptions; the policy defines requests
      per minute / hour / day and is enforced at the Choreo gateway.
policies:
  - name: Backoff Strategy
    description: On 429, retry with exponential backoff and jitter; honor Retry-After when present.
  - name: Configurable Throttling
    description: Use Choreo API Management throttling policies to set per-subscription and per-API
      request ceilings rather than relying solely on the plan-level monthly cap.
  - name: Soft vs Hard Caps
    description: The plan-level monthly request quota is a hard cap on Developer / Team; per-API
      throttling policies can be tuned without changing plan tier.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com