Skip to main content
GET
/
orgs
/
{org_id}
/
projects
/
{project_id}
/
analytics
/
users
cURL
curl --request GET \
  --url https://api.timbal.ai/orgs/{org_id}/projects/{project_id}/analytics/users \
  --header 'Authorization: Bearer <token>'
{
  "from": 123,
  "to": 123,
  "users": [
    {
      "credits": 123,
      "n_error": 123,
      "n_running": 123,
      "n_success": 123,
      "n_timeout": 123,
      "usd": 123,
      "user_email": "<string>",
      "user_id": 123,
      "user_name": "<string>",
      "user_photo_url": "<string>"
    }
  ],
  "next_page_token": "<string>"
}

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. Results are paginated: pass page_token from the previous response’s next_page_token to fetch the next page. The response includes from and to for the window you requested.

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

​
from
integer<int64>
required

Inclusive range start (epoch milliseconds).

​
to
integer<int64>
required

Exclusive range end (epoch milliseconds).

​
user_id
string | null
​
page_token
string | null

Opaque offset for the next page (from the previous response’s next_page_token).

Response

User analytics page

​
from
integer<int64>
required
​
to
integer<int64>
required
​
users
object[]
required
​
next_page_token
string | null