curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/agents \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/agents"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"agents": [
{
"id": "6a8d7b0032fd7470039135a9",
"type": "web-monitor",
"name": "Web Monitor Sofiia 25aug",
"status": "active",
"entityType": "company",
"listId": "6a8d7b01c5017e82fb6058d9",
"sourceListIds": [],
"contactsFound": 1,
"maxContacts": 50,
"expirationDate": null,
"folderId": null,
"createdAt": "2026-08-25T11:22:41.629Z",
"updatedAt": "2026-08-25T11:23:12.407Z"
},
{
"id": "6a8d7a5032fd74700391356b",
"type": "companies-watcher",
"name": "Fundraising Sofiia 25 aug",
"status": "paused",
"entityType": "company",
"listId": "6a8d7a55c5017e82fb605534",
"sourceListIds": [
"6a7ef6d7d1d092349bbf5db5"
],
"contactsFound": 0,
"maxContacts": 50,
"expirationDate": "2026-08-26T00:00:00.000Z",
"folderId": null,
"createdAt": "2026-08-25T11:19:44.831Z",
"updatedAt": "2026-08-25T11:21:07.334Z"
}
],
"pagination": {
"pageNum": 1,
"totalPages": 210,
"totalRecords": 628
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}The token owner's agents across every kind
Your agents of every kind, newest created first, one page at a time. type is the public slug (the same one you POST to at /business/agents/); status is initializing for a saved draft, then processing / active / paused / expired / failed; older agents can also read completed or deleted. contactsFound is how many results the agent has delivered so far and listId is the list holding them — read the rows with the Lists endpoints. sourceListIds is filled only for the watcher kinds, which watch an existing list. Use limit (1-100, default 25) and pageNum with pagination.totalPages to walk the whole set. The agent’s config is not included here: read it with GET /business/agents/.
Errors:
422VALIDATION_FAILED— The request failed this endpoint’s own validation —paramnames the offending field andmessagesays why.429RATE_LIMITED— The agents bucket is exhausted: 30 requests per minute or 2,000 per day per token owner, shared by every /business/agents operation (a 429 raised by the agents service is relayed with this code too). Retry after theRetry-Afterheader.500UNEXPECTED_ERROR— The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quoterequest_idto support.
Requires one of the following token scopes: agents.
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/agents \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/agents"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"agents": [
{
"id": "6a8d7b0032fd7470039135a9",
"type": "web-monitor",
"name": "Web Monitor Sofiia 25aug",
"status": "active",
"entityType": "company",
"listId": "6a8d7b01c5017e82fb6058d9",
"sourceListIds": [],
"contactsFound": 1,
"maxContacts": 50,
"expirationDate": null,
"folderId": null,
"createdAt": "2026-08-25T11:22:41.629Z",
"updatedAt": "2026-08-25T11:23:12.407Z"
},
{
"id": "6a8d7a5032fd74700391356b",
"type": "companies-watcher",
"name": "Fundraising Sofiia 25 aug",
"status": "paused",
"entityType": "company",
"listId": "6a8d7a55c5017e82fb605534",
"sourceListIds": [
"6a7ef6d7d1d092349bbf5db5"
],
"contactsFound": 0,
"maxContacts": 50,
"expirationDate": "2026-08-26T00:00:00.000Z",
"folderId": null,
"createdAt": "2026-08-25T11:19:44.831Z",
"updatedAt": "2026-08-25T11:21:07.334Z"
}
],
"pagination": {
"pageNum": 1,
"totalPages": 210,
"totalRecords": 628
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Query Parameters
Page size: how many agents to return per page (1-100, default 25).
1 <= x <= 1001-based page number (default 1); agents are ordered newest-created first. pagination.totalPages tells you when to stop.
x >= 1