API Reference
List guardrails
List active guardrails in the current account.
List active guardrails in the current account.
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.
Query parameters2 fields
limitinteger
Optional
Maximum Guardrails returned per page.
Default:20
Range: 1 - 100
pageinteger
Optional
Offset page number. Values start at 1.
Default:1
Bound: 1
03
HTTP 200Success response
GET /api/v1/guardrails
JSON
{
"guardrails": [
{
"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"
}
],
"pagination": {
"limit": 20,
"page": 1,
"pages": 1,
"total": 1
}
}
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 400Error response (400)
JSON
{
"error": "page must be an integer"
}
08
cURL example
CURL
curl -X GET https://runapi.ai/api/v1/guardrails?page=1&limit=20 \
-H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY'
09