Skip to main content
POST
Query Usage Summary

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08

Query Parameters

refresh
boolean
default:false

Body

application/json
org_id
string
required
since
string | null
until
string | null
model
string[] | null
status
string[] | null
key_id
string[] | null
team_id
string | null
member_user_id
string | null
end_user_id
string | null
request_id
string | null
limit
integer | null
default:50
Required range: 1 <= x <= 200
offset
integer | null
default:0
Required range: x >= 0

Response

Successful Response

total_requests
integer
required
successful_requests
integer
required
error_requests
integer
required
prompt_tokens
integer | null
required
completion_tokens
integer | null
required
total_tokens
integer | null
required
total_cost_usd
string | null
required
by_model
ModelBreakdown · object[]
required
total_platform_fee_usd
string | null
total_byok_platform_fee_usd
string | null
total_byok_cost_usd
string | null
total_byok_requests
integer
default:0
total_platform_requests
integer
default:0
total_byok_tokens
integer
default:0
total_platform_tokens
integer
default:0
by_model_total
integer
default:0
cached_at
string | null