Sign in

v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
usage

List inference calls

Paginated, filterable list of inference calls (detect + locate) the caller's user was billed for. Filters: date range, endpoint, free-text search. Ordered by call time DESC.

post/usage/inferences

Request body

$schemastring uri

A URL to the JSON Schema for this object.

end_datestring date-time required

End of the inferences query window.

endpoint_filterstring[] nullable

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

limitinteger

Number of inferences per page.

modelstring

Model restricts results to a single model name.

offsetinteger

Pagination offset.

searchstring

Filters by inference (event) ID substring.

session_idstring

Restricts results to inferences that ran under one phone session.

start_datestring date-time required

Beginning of the inferences query window.

Example request

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

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"
}