API Reference
Retrieve a guardrail
Retrieve one active guardrail by prefix ID.
Retrieve one active guardrail by prefix ID.
Endpoint
- Base URL
https://runapi.ai- API version
v1- Authentication
Authorization: Bearer YOUR_MANAGEMENT_API_KEY- Authorization
- Requires an account-admin Management API key.
03
JSON bodyRequest
Send values only in the listed request location.
Path parameters1 field
idstring
Required
Guardrail prefix ID, for example guardrail_abc123.
03
HTTP 200Success response
GET /api/v1/guardrails/:id
JSON
{
"allowed_models": [
"gpt-5.4"
],
"allowed_providers": [],
"assignment_count": 1,
"blocked_models": [],
"blocked_providers": [],
"created_at": "2026-07-27T10:00:00.000Z",
"credit_limit_cents": 50000,
"credit_limit_reset_interval": "monthly",
"description": "Production policy",
"enabled": true,
"id": "guardrail_123",
"model_budgets": [
{
"credit_limit_cents": 10000,
"credit_limit_reset_interval": "monthly",
"match_mode": "include",
"models": [
"gpt-5.4"
]
}
],
"name": "Production budget"
}
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/guardrails/guardrail_123 \
-H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY'
09