GET /api/v1/key/limits

Returns the current plan, limits, and remaining credit balance for the API key.

Request

GET /api/v1/key/limits
Authorization: Bearer YOUR_KEY

Response

{
  "plan": "pro",
  "daily_limit": 5000,
  "used_today": 12,
  "remaining_today": 4988,
  "rate_limit": 6000
}

Field	Type	Description
plan	string	Plan name: free, basic, pro, enterprise
daily_limit	integer	Maximum credits per day
used_today	integer	Credits used today
remaining_today	integer	Credits remaining today
rate_limit	integer	Maximum requests per hour

Status Codes

Code	Meaning
200	Success
401	Invalid or missing API key

Example — cURL

curl https://unihra.ru/api/v1/key/limits \
  -H "Authorization: Bearer YOUR_KEY"

Example — Python

import requests

resp = requests.get(
    "https://unihra.ru/api/v1/key/limits",
    headers={"Authorization": "Bearer YOUR_KEY"},
)
limits = resp.json()
print(f"Plan: {limits['plan']}")
print(f"Remaining: {limits['remaining_today']} / {limits['daily_limit']}")