Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
byok_usage | float | :heavy_check_mark: | Total external BYOK usage (in USD) for the API key | 17.38 |
byok_usage_daily | float | :heavy_check_mark: | External BYOK usage (in USD) for the current UTC day | 17.38 |
byok_usage_monthly | float | :heavy_check_mark: | External BYOK usage (in USD) for current UTC month | 17.38 |
byok_usage_weekly | float | :heavy_check_mark: | External BYOK usage (in USD) for the current UTC week (Monday-Sunday) | 17.38 |
created_at | str | :heavy_check_mark: | ISO 8601 timestamp of when the API key was created | 2025-08-24T10:30:00Z |
creator_user_id | Nullable[str] | :heavy_check_mark: | The user ID of the key creator. For organization-owned keys, this is the member who created the key. For individual users, this is the user’s own ID. | user_2dHFtVWx2n56w6HkM0000000000 |
disabled | bool | :heavy_check_mark: | Whether the API key is disabled | false |
expires_at | date | :heavy_minus_sign: | ISO 8601 UTC timestamp when the API key expires, or null if no expiration | 2027-12-31T23:59:59Z |
hash | str | :heavy_check_mark: | Unique hash identifier for the API key | f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943 |
include_byok_in_limit | bool | :heavy_check_mark: | Whether to include external BYOK usage in the credit limit | false |
label | str | :heavy_check_mark: | Human-readable label for the API key | sk-or-v1-0e6…1c96 |
limit | Nullable[float] | :heavy_check_mark: | Spending limit for the API key in USD | 100 |
limit_remaining | Nullable[float] | :heavy_check_mark: | Remaining spending limit in USD | 74.5 |
limit_reset | Nullable[str] | :heavy_check_mark: | Type of limit reset for the API key | monthly |
name | str | :heavy_check_mark: | Name of the API key | My Production Key |
updated_at | Nullable[str] | :heavy_check_mark: | ISO 8601 timestamp of when the API key was last updated | 2025-08-24T15:45:00Z |
usage | float | :heavy_check_mark: | Total OpenRouter credit usage (in USD) for the API key | 25.5 |
usage_daily | float | :heavy_check_mark: | OpenRouter credit usage (in USD) for the current UTC day | 25.5 |
usage_monthly | float | :heavy_check_mark: | OpenRouter credit usage (in USD) for the current UTC month | 25.5 |
usage_weekly | float | :heavy_check_mark: | OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday) | 25.5 |
workspace_id | str | :heavy_check_mark: | The workspace ID this API key belongs to. | 0df9e665-d932-5740-b2c7-b52af166bc11 |