Query Usage Summary | Mesh API Docs

curl -X POST https://api.meshapi.ai/v1/usage \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "org_id": "0190a1b2-3c4d-7e8f-9012-3456789abcde",
  "since": "2026-07-01",
  "until": "2026-07-14",
  "limit": 10
}'

{
  "total_requests": 1284,
  "successful_requests": 1270,
  "error_requests": 14,
  "prompt_tokens": 482913,
  "completion_tokens": 197233,
  "total_tokens": 680146,
  "total_cost_usd": "12.4832100",
  "by_model": [
    {
      "model": "openai/gpt-4o-mini",
      "requests": 900,
      "prompt_tokens": 300000,
      "completion_tokens": 120000,
      "total_tokens": 420000,
      "cost_usd": "6.1200000",
      "platform_fee_usd": "0.3060000"
    },
    {
      "model": "anthropic/claude-haiku-4.5",
      "requests": 320,
      "prompt_tokens": 150000,
      "completion_tokens": 60000,
      "total_tokens": 210000,
      "cost_usd": "4.9000000",
      "platform_fee_usd": "0.2450000"
    },
    {
      "model": "openai/text-embedding-3-small",
      "requests": 64,
      "prompt_tokens": 32913,
      "completion_tokens": 0,
      "total_tokens": 32913,
      "cost_usd": "1.4632100",
      "platform_fee_usd": "0.0731600"
    }
  ],
  "total_platform_fee_usd": "0.6241600",
  "by_model_total": 3
}

Aggregate usage stats for the authenticated caller.

Authenticate with an rsk_ API key. Results are scoped to that single key — any org_id / member filters in the body are ignored. API-key reads are computed fresh.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

refreshbooleanOptionalDefaults to false

Request

This endpoint expects an object.

org_idstringRequired

sincestring or nullOptional

untilstring or nullOptional

modellist of strings or nullOptional

statuslist of strings or nullOptional

key_idlist of strings or nullOptional

team_idstring or nullOptional

member_user_idstring or nullOptional

end_user_idstring or nullOptional

limitinteger or nullOptional1-200Defaults to 50

offsetinteger or nullOptional>=0Defaults to 0

Response

Successful Response

total_requestsinteger

successful_requestsinteger

error_requestsinteger

prompt_tokensinteger or null

completion_tokensinteger or null

total_tokensinteger or null

total_cost_usdstring or null

by_modellist of objects

total_platform_fee_usdstring or null

total_byok_platform_fee_usdstring or null

total_byok_cost_usdstring or null

total_byok_requestsintegerDefaults to 0

total_platform_requestsintegerDefaults to 0

total_byok_tokensintegerDefaults to 0

total_platform_tokensintegerDefaults to 0

by_model_totalintegerDefaults to 0

cached_atstring or null

Errors

422

Unprocessable Entity Error