main

Get Usage History

Get paginated workflow runs with usage for the organization.

get/api/v1/organizations/usage/runs

Request

start_datestring nullable

ISO 8601 date-time string (UTC). Lower bound (inclusive) on created_at.

Example:2026-04-01T00:00:00Z

end_datestring nullable

ISO 8601 date-time string (UTC). Upper bound (inclusive) on created_at.

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

pageinteger

limitinteger

filtersstring nullable

JSON-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
callDirection	radio	{ "status": "inbound" }	inbound or outbound; any other value matches all
callChannel	radio	{ "status": "telephony" }	telephony, web, or chat — the group of run modes for that channel

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.

Example:[{"attribute":"callerNumber","type":"text","value":{"value":"415555"}}]

sort_bystring nullable

Field to sort by ('duration'). Defaults to created_at.

Example:duration

sort_orderstring

Sort order ('asc' or 'desc').

authorizationstring nullable

X-API-Keystring nullable

Successful Response

total_dograh_tokensnumber required

total_duration_secondsinteger required

total_countinteger required

pageinteger required

limitinteger required

total_pagesinteger required