Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-205391153.1 KB

4a74befa0bde

usage

List inference calls

Paginated, filterable list of inference calls (detect + locate) the caller's user was billed for over a required time window (start_date/end_date). Filters: endpoint, model, session, free-text search. Order with order_by ('<field> <asc|desc>').

get/usage/inferences

Query parameters

start_datestring date-time required

Beginning of the inferences query window (RFC 3339).

Beginning of the inferences query window (RFC 3339).

end_datestring date-time required

End of the inferences query window (RFC 3339).

End of the inferences query window (RFC 3339).

limitinteger

Number of inferences per page (1-100).

Number of inferences per page (1-100).

offsetinteger

Pagination offset.

Pagination offset.

endpoint_filterstring[] nullable

Restrict results to the given vision endpoints ('detect'/'locate').

Restrict results to the given vision endpoints ('detect'/'locate').

modelstring

Restrict results to a single model name.

Restrict results to a single model name.

searchstring

Filter by inference (event) id substring.

Filter by inference (event) id substring.

session_idstring

Restrict results to inferences that ran under one phone session.

Restrict results to inferences that ran under one phone session.

order_bystring

Sort expression '<field> <asc|desc>'; field one of created_at, cost_microdollars, latency_ms, endpoint, model, inference_id. Defaults to created_at desc.

Sort expression '<field> <asc|desc>'; field one of created_at, cost_microdollars, latency_ms, endpoint, model, inference_id. Defaults to created_at desc.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

limitinteger required

Page size used for this response.

offsetinteger required

Pagination offset used for this response.

totalinteger required

Total number of inference calls matching the query.

Example response

{
  "$schema": "/api/v1/UsageInferencesResponse.json"
}