Query Usage Events | Mesh API Docs

curl -X POST https://api.meshapi.ai/v1/usage/events \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "org_id": "0190a1b2-3c4d-7e8f-9012-3456789abcde",
  "since": "2026-07-01",
  "model": [
    "openai/gpt-4o-mini"
  ],
  "status": [
    "success"
  ],
  "limit": 20,
  "offset": 0
}'

{
  "events": [
    {
      "id": "0190a1c0-0000-7000-8000-00000000e1e1",
      "key_id": "0190a1b2-0000-7000-8000-0000000000aa",
      "key_label": "prod-key",
      "request_id": "req_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "model": "openai/gpt-4o-mini",
      "model_name": "gpt-4o-mini",
      "model_provider": "openai",
      "stream": false,
      "prompt_tokens": 128,
      "completion_tokens": 64,
      "total_tokens": 192,
      "cost_usd": "0.0000480",
      "latency_ms": 812,
      "tokens_per_second": 78.82,
      "status": "success",
      "error_code": null,
      "created_at": "2026-07-14T10:15:30+00:00",
      "user_id": "user_01JZ0Q9WZ7ZK3M9YF6R8D2C4B1",
      "end_user_id": "customer-42",
      "model_type": "text",
      "is_byok": false,
      "provider": "openai",
      "fallback_triggered": false,
      "platform_fee_usd": "0.0000024",
      "attempt_no": 1,
      "is_retry_attempt": false,
      "routing_fallback": false
    }
  ],
  "total": 1284,
  "limit": 50,
  "offset": 0
}

Paginated per-request event history 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

eventslist of objects

totalinteger

limitinteger

offsetinteger

Errors

422

Unprocessable Entity Error