Status
Operations tagged Status in the public API.
About Status
GET /status is the API's health check: unauthenticated, free of any account data, and limited per client IP. A 200 means the API is serving requests, and version is the contract version every response also sends in the Agentency-Version header.
It does not check a key, credits or background work: GET /me tells you a key works and GET /usage how many credits are left. While the public API is switched off for a deployment, this and every other /v1 route answers 404 FEATURE_DISABLED.
IDs you will meet.
id— alwaysagentency.
Check API status
The health check for monitors: no key, no scope, and nothing about any account. A 200 with
status: ok means the API is serving requests — not that a key works or that credits remain (GET /me and GET /usage answer those). Limited per client IP; once a minute is plenty for an uptime check.- Idempotency
- Read-only
- Rate limits
Responses
- 200Success.
objectstringRequiredAlways
statusidstringRequiredAlwaysagentency.Always
agentencystatusstringRequiredAlwaysok: the endpoint answers only while the API serves requests.Always
okapistringRequiredThe path version that answered,v1.Always
v1versionstringRequiredThe contract version (a date), the same value as theAgentency-Versionheader andinfo.versionof this document.
- 429Rate limited. Honour Retry-After.
Error codesRATE_LIMITED
- 500Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR
Request
curl
curl -X GET 'https://api.agentency.com/v1/status' \
-H "Authorization: Bearer <YOUR_KEY>" \
-H "Content-Type: application/json"Response
Example 200 response
json
{
"object": "status",
"id": "agentency",
"status": "ok",
"api": "v1",
"version": "2026-08-14"
}