List durable report execution runs
LogsGET /executions
Returns the tenant's report runs with their definition, status (pending, running, completed or failed), row count, timings, error message and, when completed, the CSV download path. Results are cursor-paginated (default 20, maximum 100); the handler also accepts definition_id and status filters. Requires the reports:read permission.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 Report executions
Show attributes
dataShow child attributes
idtenant_iddefinition_idtriggered_bystatusone of
pending,running,completed,failedparameterslocaleThe requester's language, captured when the export is queued. The CSV download and the PDF label columns and enum values in it. Absent for API keys and system runs, whose CSV keeps the snake_case column keys and raw values.
one of
pt-MZ,en-USrow_countdownload_urlerror_messagestarted_atcompleted_atcreated_at
has_morenext_cursor
Errors 403
Permissions reports:read · Roles: admin, analyst, finance, owner
curl -X GET "$BUSINESS_API/executions" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/executions", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/executions",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/executions", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "rep_2PJiWXxcUzzWiDtIAPJaoNNWqNF",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"definition_id": "def_2dL2WhtIu5Vmo51mWVHA0zjwE3L",
"triggered_by": "triggered by",
"status": "pending",
"parameters": {},
"locale": "pt-MZ",
"row_count": 1,
"download_url": "https://example.org/",
"error_message": "error message",
"started_at": "2026-11-19T09:30:00Z",
"completed_at": "2026-11-19T09:30:00Z",
"created_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}