Skip to main content
GET
/
orgs
/
{org_id}
/
projects
/
{project_id}
/
analytics
/
usage
cURL
curl --request GET \
  --url https://api.timbal.ai/orgs/{org_id}/projects/{project_id}/analytics/usage \
  --header 'Authorization: Bearer <token>'
{
  "bins": [
    {
      "interval_ends_at": 123,
      "interval_starts_at": 123,
      "n_error": 123,
      "n_running": 123,
      "n_success": 123,
      "n_timeout": 123,
      "n_users": 123,
      "p50": 123,
      "p90": 123,
      "p95": 123,
      "p99": 123
    }
  ],
  "from": 123,
  "to": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.timbal.ai/llms.txt

Use this file to discover all available pages before exploring further.

Only project admins can call this endpoint. Each response returns at most 1440 time bins; there is no pagination. You may omit group_by, from, and/or to — the server applies defaults — and the JSON body includes group_by, from, and to so you can see the bin size and range that were actually used.

Authorizations

​
Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

​
org_id
string
required
​
project_id
string
required

Query Parameters

​
group_by
enum<string>

Bucket size for aggregation (minute, hour, or day).

Available options:
minute,
hour,
day
​
from
integer<int64> | null
​
to
integer<int64> | null
​
user_id
string | null

Response

Usage analytics

​
bins
object[]
required
​
from
integer<int64>
required
​
group_by
enum<string>
required
Available options:
minute,
hour,
day
​
to
integer<int64>
required