Skip to main content
The Python SDK and docs are currently in beta. Report issues on GitHub.
Current API key information

Fields

FieldTypeRequiredDescriptionExample
labelstr:heavy_check_mark:Human-readable label for the API keysk-or-v1-0e6f44a47a05f1dad2ad7e88c4c1d6b77688157716fb1a5271146f7464951c96
limitNullable[float]:heavy_check_mark:Spending limit for the API key in USD100
usagefloat:heavy_check_mark:Total OpenRouter credit usage (in USD) for the API key25.5
usage_dailyfloat:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC day25.5
usage_weeklyfloat:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday)25.5
usage_monthlyfloat:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC month25.5
byok_usagefloat:heavy_check_mark:Total external BYOK usage (in USD) for the API key17.38
byok_usage_dailyfloat:heavy_check_mark:External BYOK usage (in USD) for the current UTC day17.38
byok_usage_weeklyfloat:heavy_check_mark:External BYOK usage (in USD) for the current UTC week (Monday-Sunday)17.38
byok_usage_monthlyfloat:heavy_check_mark:External BYOK usage (in USD) for current UTC month17.38
is_free_tierbool:heavy_check_mark:Whether this is a free tier API keyfalse
is_provisioning_keybool:heavy_check_mark:Whether this is a provisioning keyfalse
limit_remainingNullable[float]:heavy_check_mark:Remaining spending limit in USD74.5
limit_resetNullable[str]:heavy_check_mark:Type of limit reset for the API keymonthly
include_byok_in_limitbool:heavy_check_mark:Whether to include external BYOK usage in the credit limitfalse
expires_atdate:heavy_minus_sign:ISO 8601 UTC timestamp when the API key expires, or null if no expiration2027-12-31T23:59:59Z
rate_limitoperations.RateLimit:heavy_check_mark:: warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Legacy rate limit information about a key. Will always return -1.
{"requests": 1000,"interval": "1h","note": "This field is deprecated and safe to ignore."}