Request
curl https://kymaapi.com/v1/auth/limits \
-H "Authorization: Bearer kyma-your-api-key"
Response
The tier ladder is not copied here.next_tier and every entry of all_tiers have the
same fields as a row of the public GET /v1/limits/tiers,
plus min_spend (equal to min_deposit). Read the numbers from there.
{
"tier": 0,
"tier_name": "Tier 0",
"lifetime_purchased": 0,
"next_tier": { "tier": 1, "name": "Tier 1", "min_deposit": 5, "min_spend": 5 /* …the other GET /v1/limits/tiers fields */ },
"deposit_to_next_tier": 5,
"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-09-22T15:05:00.000Z",
"all_tiers": [ /* one object per tier, Tier 0 to Tier 4 */ ],
"text_limits": { "per_minute_limit": 30, "per_minute_used": 3, "per_minute_remaining": 27, "concurrent_limit": 0, "concurrent_used": 0, "unit": "requests" },
"image_limits": { "per_minute_limit": 0, "per_minute_used": 0, "per_minute_remaining": 0, "concurrent_limit": 2, "concurrent_used": 0, "unit": "images" },
"video_limits": { "per_minute_limit": 0, "per_minute_used": 0, "per_minute_remaining": 0, "concurrent_limit": 0, "concurrent_used": 0, "unit": "video_seconds" },
"audio_limits": { "per_minute_limit": 0, "per_minute_used": 0, "per_minute_remaining": 0, "concurrent_limit": 2, "concurrent_used": 0, "unit": "audio_requests" },
"lifetime_spent": 0,
"spend_to_next_tier": 5
}
| Field | Description |
|---|---|
tier | Current tier (0-4) |
tier_name | Tier display name |
lifetime_purchased | Total credits purchased, card or machine top-up (determines tier) |
next_tier | Next tier’s row (null on Tier 4) |
deposit_to_next_tier | Credits to purchase to unlock the next tier |
rpm_limit | Max requests per minute (total) |
per_model_rpm_limit | Max requests per minute per model. Paid tiers have no per-model cap, so this repeats rpm_limit there |
tpm_limit | Max tokens per minute |
rpm_used, tpm_used | Requests and tokens counted against your limits in the current minute. rpm_remaining and tpm_remaining are the limit minus these. Calling this endpoint does not count as a request |
used_today | Total requests today (UTC) |
resets_at | Start of the next minute (UTC), when the per-minute counters reset |
all_tiers | All tier rows, for display |
text_limits, image_limits, video_limits, audio_limits | Per-kind limits. text_limits.per_minute_used repeats rpm_used; the concurrent_used fields are 0 today |
lifetime_spent, spend_to_next_tier | Same values as lifetime_purchased and deposit_to_next_tier |