Read credit balance and plan

Returns the authenticated organization's current Ray9 credit balance (in mils, 1/1000 USD) and active plan. Read-only — no credits charged, no rate limit beyond per-org inbound. Used by the MCP `usage.get` tool and the Ray9 web app's billing surface.

GET
/v1/usage

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "http://api.ray9.localhost:1355/v1/usage"
{
  "creditBalanceMils": 0,
  "plan": "free"
}
{
  "requestId": "string",
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
{
  "requestId": "string",
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
{
  "requestId": "string",
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}