List agent runs
curl --request GET \
--url https://api.entendre.finance/v1/agents/{agent_id}/runs \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.entendre.finance/v1/agents/{agent_id}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.entendre.finance/v1/agents/{agent_id}/runs"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "run_xyz789",
"status": "in_progress",
"success_data": null,
"error_data": null,
"error_message": null,
"reviewed_by": null,
"reviewed_at": null,
"created_at": "2026-08-31T12:00:00Z",
"updated_at": "2026-08-31T12:00:00Z",
"agent_id": "agt_507f1f77bcf86cd799439011",
"review": {
"status": "not_required",
"reviewer_user_id": null,
"review_url": null,
"reviewed_at": null
},
"result_links": [],
"status_url": "/v1/agents/agt_507f1f77bcf86cd799439011/runs?run_ids=run_xyz789"
}
],
"has_more": false,
"next_cursor": null
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid path, query or request body.",
"request_id": "req_example"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API Key",
"request_id": "req_example",
"suggested_action": "Send an API key in X-API-Key, or an OAuth access token as Authorization: Bearer. Refresh an expired access token.",
"documentation_url": "https://entendre.ai/docs/get-started/authentication"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient access to organization",
"request_id": "req_example"
}
}{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"request_id": "req_example"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 30s.",
"request_id": "req_example"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_example"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service unavailable.",
"request_id": "req_example"
}
}Agents
List agent runs
Lists agent runs with their status, results, errors and review details.
GET
/
v1
/
agents
/
{agent_id}
/
runs
List agent runs
curl --request GET \
--url https://api.entendre.finance/v1/agents/{agent_id}/runs \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.entendre.finance/v1/agents/{agent_id}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.entendre.finance/v1/agents/{agent_id}/runs"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "run_xyz789",
"status": "in_progress",
"success_data": null,
"error_data": null,
"error_message": null,
"reviewed_by": null,
"reviewed_at": null,
"created_at": "2026-08-31T12:00:00Z",
"updated_at": "2026-08-31T12:00:00Z",
"agent_id": "agt_507f1f77bcf86cd799439011",
"review": {
"status": "not_required",
"reviewer_user_id": null,
"review_url": null,
"reviewed_at": null
},
"result_links": [],
"status_url": "/v1/agents/agt_507f1f77bcf86cd799439011/runs?run_ids=run_xyz789"
}
],
"has_more": false,
"next_cursor": null
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid path, query or request body.",
"request_id": "req_example"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API Key",
"request_id": "req_example",
"suggested_action": "Send an API key in X-API-Key, or an OAuth access token as Authorization: Bearer. Refresh an expired access token.",
"documentation_url": "https://entendre.ai/docs/get-started/authentication"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient access to organization",
"request_id": "req_example"
}
}{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"request_id": "req_example"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 30s.",
"request_id": "req_example"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_example"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service unavailable.",
"request_id": "req_example"
}
}To check a run, filter by its ID in
run_ids and read data[0]. Do not add a status filter while you poll.
A run in pending_review needs a review by an authorized user at review.review_url; the API cannot approve it. The results, errors and review decision stay available here.
skipped means that the agent was paused or archived before the run started. A cancelled run currently ends as error; the meta.cancellation_status of the cancel response shows the outcome.Authorizations
Your organization API key. See Authentication.
Path Parameters
ID of the agent.
Minimum string length:
1Query Parameters
IDs to return, separated by commas. The other filters also apply.
Required array length:
1 - 100 elementsMinimum string length:
1Maximum number of records to return.
Required range:
1 <= x <= 100The next_cursor value from the previous page. Keep the other filters unchanged.
Run status.
Available options:
in_progress, pending_review, success, error, skipped