Skip to main content
GET
Get usage consumption for a user within a time window

Authorizations

Authorization
string
header
required

JWT access token obtained from the /auth/token endpoint.

This Admin API is separate from the Corti API used for speech recognition, text generation, and agentic workflows. Authentication and scope for the Admin API uses email-and-password to obtain a bearer token via /auth/token. This token is only used for API administration.

Path Parameters

projectId
string
required

Unique identifier of your project in the Corti API Console.

To find it, open your project at console.corti.app, go to Settings, and copy the value from the Project ID field.

Example:

"consoleproject"

customerId
string
required

The unique identifier for a Customer

Example:

"contosohospital"

userId
string<uuid>
required

The ID of the user

Example:

"123e4567-e89b-12d3-a456-426614174000"

Query Parameters

from
string<date-time>
required

Start of the time range (inclusive), in RFC 3339 / UTC. Rounded down to the start of the containing hour before querying usage data — see the endpoint description for details.

Example:

"2026-01-05T00:00:00Z"

to
string<date-time>
required

End of the time range (inclusive), in RFC 3339 / UTC. Rounded up to the end of the containing hour before querying usage data — see the endpoint description for details.

Example:

"2026-01-17T00:00:00Z"

Response

Consumption for the requested user and window

consumption
number<double>
required

Total credits consumed in the requested window