Skip to main content
GET
Tier Matrix
Public, no authentication required. Returns Kyma’s complete rate-limit tier ladder so docs, dashboard signup flows, and external tools can show “what you unlock at each spend threshold” without hardcoding the matrix in two places. The response is Cache-Control: public, max-age=300 (5 minutes).

Response

object
string
Always "tier.matrix".
tiers
array
Array of 5 tier definitions, ordered Tier 0 → Tier 4.

Tier fields

Use cases

  • Dashboard signup flow: show “deposit $5 to unlock 60 RPM + 10 concurrent image” inline.
  • Pricing page: render tier comparison table without hardcoding numbers.
  • External capacity planner: developers building products on Kyma can fetch tier caps and budget concurrency client-side.
  • CI test fixture: lock test expectations against the live matrix.

Caching

Cache-Control: public, max-age=300 (5 minutes). Tier matrix changes infrequently (typically only when Kyma raises caps, e.g. after upstream key rotation or quota upgrades).

Errors

Public read-only — no auth errors. Only failure mode is 500 on internal error.
  • GET /v1/pricing — companion catalog of all SKU pricing
  • Rate Limits guide — full human-readable explanation with audio sub-pool reasoning, queue + backpressure semantics, 429 response shape, and the “Need higher limits?” CTA
  • GET /v1/auth/limits — your account’s CURRENT tier (requires auth, returns your specific tier_override if set)