Skip to main content
GET
/
projects
/
{projectId}
/
customers
/
{customerId}
/
users
/
{userId}
/
consumption
Get usage consumption for a user within a time window
curl --request GET \
  --url https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers/{customerId}/users/{userId}/consumption \
  --header 'Authorization: Bearer <token>'
{
  "consumption": 123
}

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 format

Example:

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

to
string<date-time>
required

End of the time range (inclusive) in RFC 3339 format

Example:

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

windowTimeZone
string
default:UTC

Time zone name as defined by the IANA Time Zone Database (defaults to UTC)

Response

Consumption for the requested user and window

consumption
number<double>
required

Total credits consumed in the requested window