API Reference
Retrieve an API key
Retrieve one Standard API key and its current usage summary.
Retrieve one Standard API key and its current usage summary.
Endpoint
- Base URL
https://runapi.ai- API version
v1- Authentication
Authorization: Bearer YOUR_MANAGEMENT_API_KEY- Authorization
- Requires an account-admin Management API key and permits only keys owned by its user.
03
JSON bodyRequest
Send values only in the listed request location.
Path parameters1 field
idstring
Required
API key prefix ID, for example token_123.
03
HTTP 200Success response
GET /api/v1/keys/:id
JSON
{
"allowed_models": [
"gpt-5.4"
],
"created_at": "2026-07-27T10:00:00.000Z",
"credit_limit_cents": 1000,
"credit_limit_reset_interval": "daily",
"credit_usage_cents_by_model": {
"gpt-5.4": 250
},
"credit_usage_cents_this_month": 250,
"credit_usage_cents_this_week": 100,
"credit_usage_cents_today": 25,
"credit_usage_cents_total": 250,
"enabled": true,
"guardrail_id": "guardrail_123",
"id": "token_123",
"last_used_at": null,
"masked_token": "runapi_abc...wxyz",
"name": "Production"
}
04
HTTP 401Error response (401)
JSON
{
"error": "Authentication required"
}
05
HTTP 403Error response (403)
JSON
{
"error": "Management API key required"
}
06
HTTP 403Error response (403)
JSON
{
"error": "Account admin required"
}
07
HTTP 404Error response (404)
JSON
{
"error": "Resource not found"
}
08
cURL example
CURL
curl -X GET https://runapi.ai/api/v1/keys/token_123 \
-H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY'
09