Get API key spend limits
Returns your spending limits for this API key, plus how much of your daily and monthly budget you have used.
GET
/v1/limitsResponses
200Current API key spend policy and budget-window usage
dataobjectrequiredShow propertiesHide properties
policyobjectrequiredShow propertiesHide properties
max_credits_per_requestintegerrequiredmin 0
approval_threshold_creditsintegerrequiredmin 0
allowed_modelsstring[] | nullrequiredmax items 200
dailyobjectrequiredShow propertiesHide properties
limitintegerrequiredmin 0
usedintegerrequiredmin 0
remainingintegerrequiredmin 0
reset_atstring<date-time>requiredmonthlyobjectrequiredShow propertiesHide properties
limitintegerrequiredmin 0
usedintegerrequiredmin 0
remainingintegerrequiredmin 0
reset_atstring<date-time>required503The authoritative spend-limit snapshot is unavailable
errorobjectrequiredShow propertiesHide properties
codestringrequiredmin length 1 · max length 128
messagestringrequiredmin length 1 · max length 2000
retryablebooleanrequiredrequest_idstring<uuid>requiredbalanceintegermin 0
requiredintegermin 0
fieldstringmin length 1 · max length 512
statestringmin length 1 · max length 128
retryWithNewKeybooleanparameterstringmin length 1 · max length 128
allowedstring[]max items 100
Request
curl -X GET "https://api.roasos.com/v1/limits"const response = await fetch("https://api.roasos.com/v1/limits", {
method: "GET"
});import requests
response = requests.get(
"https://api.roasos.com/v1/limits",
)Response
{
"data": {
"policy": {
"max_credits_per_request": 0,
"approval_threshold_credits": 0,
"allowed_models": [
"string"
]
},
"daily": {
"limit": 0,
"used": 0,
"remaining": 0,
"reset_at": "2024-01-01T00:00:00Z"
},
"monthly": {
"limit": 0,
"used": 0,
"remaining": 0,
"reset_at": "2024-01-01T00:00:00Z"
}
}
}{
"error": {
"code": "string",
"message": "string",
"retryable": true,
"request_id": "<uuid>",
"balance": 0,
"required": 0,
"field": "string",
"state": "string",
"retryWithNewKey": true,
"parameter": "string",
"allowed": [
"string"
]
}
}