List Runs with Usage
Paginated list of workflow runs across the organization with usage and cost
Returns a paginated list of runs across all agents in your organization, including duration, cost, and usage details for each run.
Use start_date and end_date (ISO 8601) to scope the window, and page / limit to paginate. Pass filters as a JSON-encoded string to narrow results further.
To fetch the full transcript or recording for a specific run, use Retrieve Agent Run Details.
Query Parameters
ISO 8601 date-time string (UTC). Lower bound (inclusive) on created_at.
ISO 8601 date-time string (UTC). Upper bound (inclusive) on created_at.
1 <= value11 <= value <= 10050JSON-encoded array of filter objects. Each object has the shape:
{ "attribute": "<name>", "type": "<type>", "value": <value> }Supported attribute / type / value combinations:
| attribute | type | value shape | matches |
|---|---|---|---|
runId | number | { "value": 12345 } | exact run id |
workflowId | number | { "value": 42 } | exact agent (workflow) id |
campaignId | number | { "value": 7 } | exact campaign id |
callerNumber | text | { "value": "415555" } | substring match on initial_context.caller_number |
calledNumber | text | { "value": "9911848" } | substring match on initial_context.called_number |
dispositionCode | multiSelect | { "codes": ["XFER", "DNC"] } | any of the codes in gathered_context.mapped_call_disposition |
duration | numberRange | { "min": 60, "max": 300 } | call duration (seconds), inclusive bounds |
Unknown attributes and unsupported type values are silently ignored.
Date filtering on this endpoint is done via the dedicated start_date / end_date query params, not via a dateRange filter object.
Header Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/organizations/usage/runs"{ "runs": [ { "id": 0, "workflow_id": 0, "workflow_name": "string", "name": "string", "created_at": "string", "talkr_token_usage": 0, "call_duration_seconds": 0, "recording_url": "string", "transcript_url": "string", "user_recording_url": "string", "bot_recording_url": "string", "recording_public_url": "string", "transcript_public_url": "string", "user_recording_public_url": "string", "bot_recording_public_url": "string", "public_access_token": "string", "phone_number": "string", "caller_number": "string", "called_number": "string", "call_type": "string", "mode": "string", "disposition": "string", "initial_context": {}, "gathered_context": {}, "charge_usd": 0 } ], "total_talkr_tokens": 0, "total_duration_seconds": 0, "total_count": 0, "page": 0, "limit": 0, "total_pages": 0}