curl, made-up values
curl 'https://api.poddata.ai/v1/diligence-runs/drn_01JD9M7Q8R9S00000000000000' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/diligence-runs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/diligence-runs/{id}', 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://api.poddata.ai/v1/diligence-runs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.poddata.ai/v1/diligence-runs/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/diligence-runs/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/diligence-runs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "drn_01JD9M7Q8R9S00000000000000",
"report": "dlr_01JD9K4M5N6P00000000000000",
"company": "northwind-dental",
"kind": "write",
"message": null,
"status": "done",
"why": null,
"model": "claude-sonnet-5-5",
"playbook": "2",
"usd": 3.42,
"cap_usd": 5,
"turns": 61,
"agents": [
{
"name": "customer",
"status": "done",
"why": null,
"turns": 12,
"usd": 0.71,
"trace": [
{
"turn": 1,
"at": "2026-11-14T10:00:20.000Z",
"model": "claude-sonnet-5-5",
"usd": 0.06,
"stop": "tool_use",
"tokens": {
"input": 18240,
"cache_write": 9120,
"cache_read": 0,
"output": 412
},
"tools": [
{
"name": "numbers_rating_rivals",
"ok": true,
"chars": 6214
}
]
}
]
},
{
"name": "competitive",
"status": "done",
"why": null,
"turns": 14,
"usd": 0.83
},
{
"name": "news",
"status": "done",
"why": null,
"turns": 9,
"usd": 0.48
},
{
"name": "trends",
"status": "done",
"why": null,
"turns": 8,
"usd": 0.44
},
{
"name": "expert",
"status": "done",
"why": null,
"turns": 10,
"usd": 0.52
},
{
"name": "overview",
"status": "done",
"why": null,
"turns": 4,
"usd": 0.21
},
{
"name": "check-1",
"status": "done",
"why": null,
"turns": 4,
"usd": 0.23
}
],
"refusals": [],
"started_by": {
"via": "key",
"key": "key_01JD9H6J7K8M00000000000000"
},
"created_at": "2026-11-14T10:00:00.000Z",
"updated_at": "2026-11-14T10:19:00.000Z",
"ended_at": "2026-11-14T10:19:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Report runs
One run of PodData's agent: where it stands, what it cost, and each agent's turns and tool calls
One run of PodData’s agent: where it stands, what it cost against its cap, the check’s last refusals, and each agent’s trace, a turn at a time: its model, cost, tokens, why it stopped, and each tool it called with whether it answered and how long its answer was. No source’s words are in a run.
Before: Its id, from a report’s runs.
Next: Read it again, a minute or so apart, until it ends. When it’s done, GET /diligence-reports/{id} reads the report; when it’s capped, it stopped at its cap with pages left to write.
Limits: One a call. Another team’s run is a 404.
GET
/
diligence-runs
/
{id}
curl, made-up values
curl 'https://api.poddata.ai/v1/diligence-runs/drn_01JD9M7Q8R9S00000000000000' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/diligence-runs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/diligence-runs/{id}', 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://api.poddata.ai/v1/diligence-runs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.poddata.ai/v1/diligence-runs/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/diligence-runs/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/diligence-runs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "drn_01JD9M7Q8R9S00000000000000",
"report": "dlr_01JD9K4M5N6P00000000000000",
"company": "northwind-dental",
"kind": "write",
"message": null,
"status": "done",
"why": null,
"model": "claude-sonnet-5-5",
"playbook": "2",
"usd": 3.42,
"cap_usd": 5,
"turns": 61,
"agents": [
{
"name": "customer",
"status": "done",
"why": null,
"turns": 12,
"usd": 0.71,
"trace": [
{
"turn": 1,
"at": "2026-11-14T10:00:20.000Z",
"model": "claude-sonnet-5-5",
"usd": 0.06,
"stop": "tool_use",
"tokens": {
"input": 18240,
"cache_write": 9120,
"cache_read": 0,
"output": 412
},
"tools": [
{
"name": "numbers_rating_rivals",
"ok": true,
"chars": 6214
}
]
}
]
},
{
"name": "competitive",
"status": "done",
"why": null,
"turns": 14,
"usd": 0.83
},
{
"name": "news",
"status": "done",
"why": null,
"turns": 9,
"usd": 0.48
},
{
"name": "trends",
"status": "done",
"why": null,
"turns": 8,
"usd": 0.44
},
{
"name": "expert",
"status": "done",
"why": null,
"turns": 10,
"usd": 0.52
},
{
"name": "overview",
"status": "done",
"why": null,
"turns": 4,
"usd": 0.21
},
{
"name": "check-1",
"status": "done",
"why": null,
"turns": 4,
"usd": 0.23
}
],
"refusals": [],
"started_by": {
"via": "key",
"key": "key_01JD9H6J7K8M00000000000000"
},
"created_at": "2026-11-14T10:00:00.000Z",
"updated_at": "2026-11-14T10:19:00.000Z",
"ended_at": "2026-11-14T10:19:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}MCP tool:
get_report_run, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.Authorizations
Response
The run, with each agent's trace