Skip to main content
GET
/
orgs
/
{org_id}
/
projects
/
{project_id}
/
runs
cURL
curl --request GET \
  --url https://api.timbal.ai/orgs/{org_id}/projects/{project_id}/runs \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {
      "cost_credits": 123,
      "cost_usd": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "idempotency_key": "<string>",
      "status": "<string>",
      "user": {
        "email": "<string>",
        "id": "<string>",
        "name": "<string>",
        "photo_url": "<string>"
      },
      "workforce": {
        "id": "<string>",
        "name": "<string>",
        "type": "agent",
        "deleted_at": 123,
        "description": "<string>",
        "uid": "<string>",
        "url": "<string>"
      },
      "duration_ms": 123,
      "group_id": "<string>",
      "last_reaction_sentiment": "<string>",
      "parent_id": "<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.

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

​
user_id
string | null

Filter runs by user ID

​
status
string | null

Filter runs by status

​
sentiment
string | null

Filter runs by sentiment

​
group_id
string | null

Filter runs by group ID

​
workforce_id
string | null

Filter runs by workforce ID

​
rev
string | null

Filter runs by the git branch they were executed against (e.g. main). Runs without a recorded branch are always included for backwards compatibility with rows created before this field was tracked.

​
from
integer<int64> | null

Filter runs by start time (epoch timestamp in milliseconds)

​
to
integer<int64> | null

Filter runs by end time (epoch timestamp in milliseconds)

​
metadata
string | null

Filter runs by metadata

​
page_token
string | null

Page token

Response

200 - application/json

Runs listed successfully

​
runs
object[]
required

List of runs

​
next_page_token
string | null

Cursor for the next page