Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kymaapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Request

curl https://kymaapi.com/v1/auth/limits \
  -H "Authorization: Bearer ky-your-api-key"

​
Response

{
  "tier": 0,
  "tier_name": "Tier 0",
  "lifetime_purchased": 0.00,
  "next_tier": {
    "tier": 1,
    "name": "Tier 1",
    "min_deposit": 5,
    "rpm": 60,
    "per_model_rpm": 40,
    "tpm": 500000
  },
  "deposit_to_next_tier": 5.00,
  "rpm_limit": 30,
  "rpm_used": 3,
  "rpm_remaining": 27,
  "per_model_rpm_limit": 25,
  "tpm_limit": 200000,
  "tpm_used": 1200,
  "tpm_remaining": 198800,
  "used_today": 42,
  "resets_at": "2026-04-06T07:00:00.000Z",
  "all_tiers": [
    { "tier": 0, "name": "Tier 0", "min_deposit": 0, "rpm": 30, "per_model_rpm": 25, "tpm": 200000 },
    { "tier": 1, "name": "Tier 1", "min_deposit": 5, "rpm": 60, "per_model_rpm": 40, "tpm": 500000 },
    { "tier": 2, "name": "Tier 2", "min_deposit": 50, "rpm": 120, "per_model_rpm": 80, "tpm": 2000000 },
    { "tier": 3, "name": "Tier 3", "min_deposit": 250, "rpm": 200, "per_model_rpm": 150, "tpm": 5000000 },
    { "tier": 4, "name": "Tier 4", "min_deposit": 1000, "rpm": 300, "per_model_rpm": 200, "tpm": 10000000 }
  ]
}
FieldDescription
tierCurrent tier (0-4)
tier_nameTier display name
lifetime_purchasedTotal credits purchased (determines tier)
next_tierNext tier details (null if max)
deposit_to_next_tierCredits to purchase to unlock next tier
rpm_limitMax requests per minute (total)
rpm_usedRequests used this minute
rpm_remainingRequests remaining this minute
per_model_rpm_limitMax requests per minute per model
tpm_limitMax tokens per minute
tpm_usedTokens used this minute
tpm_remainingTokens remaining this minute
used_todayTotal requests today
resets_atWhen the per-minute counters reset
all_tiersAll tier definitions for UI display