For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
ModelsChatRankingsDocs
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
DocsAPI ReferenceClient SDKsAgent SDKCookbookChangelog
  • API Guides
    • Overview
    • Streaming
    • Embeddings
    • Limits
    • Authentication
    • Parameters
    • Errors and Debugging
  • API Reference
      • GETGet current API key
      • GETList API keys
      • POSTCreate a new API key
      • GETGet a single API key
      • DELDelete an API key
      • PATCHUpdate an API key
LogoLogo
ModelsChatRankingsDocs
API ReferenceAPI Keys

Get a single API key

GET
https://openrouter.ai/api/v1/keys/:hash
GET
/api/v1/keys/:hash
$curl https://openrouter.ai/api/v1/keys/f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943 \
>     -H "Authorization: Bearer <token>"
1{
2  "data": {
3    "byok_usage": 17.38,
4    "byok_usage_daily": 17.38,
5    "byok_usage_monthly": 17.38,
6    "byok_usage_weekly": 17.38,
7    "created_at": "2025-08-24T10:30:00Z",
8    "creator_user_id": "user_2dHFtVWx2n56w6HkM0000000000",
9    "disabled": false,
10    "hash": "f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943",
11    "include_byok_in_limit": false,
12    "label": "Production API Key",
13    "limit": 100,
14    "limit_remaining": 74.5,
15    "limit_reset": "monthly",
16    "name": "My Production Key",
17    "updated_at": "2025-08-24T15:45:00Z",
18    "usage": 25.5,
19    "usage_daily": 25.5,
20    "usage_monthly": 25.5,
21    "usage_weekly": 25.5,
22    "workspace_id": "0df9e665-d932-5740-b2c7-b52af166bc11",
23    "expires_at": "2027-12-31T23:59:59Z"
24  }
25}

Get a single API key by hash. Management key required.

Was this page helpful?
Previous

Delete an API key

Next
Built with

Authentication

AuthorizationBearer
API key as bearer token in Authorization header

Path parameters

hashstringRequired
The hash identifier of the API key to retrieve

Response

API key details
dataobject
The API key information

Errors

401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error