Get Usage History
curl --request GET \
--url https://app.dograh.com/api/v1/organizations/usage/runsimport requests
url = "https://app.dograh.com/api/v1/organizations/usage/runs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.dograh.com/api/v1/organizations/usage/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.dograh.com/api/v1/organizations/usage/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.dograh.com/api/v1/organizations/usage/runs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.dograh.com/api/v1/organizations/usage/runs")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.dograh.com/api/v1/organizations/usage/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"runs": [
{
"id": 123,
"workflow_id": 123,
"workflow_name": "<string>",
"name": "<string>",
"created_at": "<string>",
"dograh_token_usage": 123,
"call_duration_seconds": 123,
"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": 123
}
],
"total_dograh_tokens": 123,
"total_duration_seconds": 123,
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Runs
List Runs with Usage
Paginated list of workflow runs across the organization with usage and cost
GET
/
api
/
v1
/
organizations
/
usage
/
runs
Get Usage History
curl --request GET \
--url https://app.dograh.com/api/v1/organizations/usage/runsimport requests
url = "https://app.dograh.com/api/v1/organizations/usage/runs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.dograh.com/api/v1/organizations/usage/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.dograh.com/api/v1/organizations/usage/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.dograh.com/api/v1/organizations/usage/runs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.dograh.com/api/v1/organizations/usage/runs")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.dograh.com/api/v1/organizations/usage/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"runs": [
{
"id": 123,
"workflow_id": 123,
"workflow_name": "<string>",
"name": "<string>",
"created_at": "<string>",
"dograh_token_usage": 123,
"call_duration_seconds": 123,
"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": 123
}
],
"total_dograh_tokens": 123,
"total_duration_seconds": 123,
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}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.
Example:
"2026-04-01T00:00:00Z"
ISO 8601 date-time string (UTC). Upper bound (inclusive) on created_at.
Example:
"2026-05-01T00:00:00Z"
Required range:
x >= 1Required range:
1 <= x <= 100JSON-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.
Example:
"[{\"attribute\":\"callerNumber\",\"type\":\"text\",\"value\":{\"value\":\"415555\"}}]"
โI