v16

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-032765158.3 KB
Usage

Get Query Usage

Query usage (fine/coarse/pages/documents queries).

post/usage/queries

Request body

start_timeinteger required

Start time for the usage query (inclusive) - Unix timestamp (seconds since epoch)

end_timeinteger required

End time for the usage query (inclusive) - Unix timestamp (seconds since epoch)

aggregation_window'minutely' | 'hourly' | 'daily' required
collection_namesstring[] nullable

Optional list of collection names to filter by. If None, returns data for all collections.

Response

Successful Response

window_startinteger required
organization_idstring uuid required
collection_idstring uuid required
query_type'fine' | 'coarse' | 'pages' | 'documents' required
event_countinteger required
total_query_bytesinteger required
total_queried_bytesinteger required
total_query_tokensinteger required
total_results_returnedinteger required
total_time_taken_msnumber required