---
title: "The token owner's agents across every kind"
method: GET
path: "/business/agents"
tags: ["Agents"]
---

# The token owner's agents across every kind

`GET /business/agents`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/agents`
- Auth: HTTP basic

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/{type}); `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/{agentId}.

Errors:
- `422` `VALIDATION_FAILED` — The request failed this endpoint's own validation — `param` names the offending field and `message` says why.
- `429` `RATE_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 the `Retry-After` header.
- `500` `UNEXPECTED_ERROR` — The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quote `request_id` to support.

Requires one of the following token scopes: agents.

## Query parameters

- `limit` integer: Page size: how many agents to return per page (1-100, default 25).
- `pageNum` integer: 1-based page number (default 1); agents are ordered newest-created first. `pagination.totalPages` tells you when to stop.

## Response `200`

Success

- object
  - `agents` object[], required
    - `id` string, required: The agent's id — pass it as `{agentId}` to every other agent operation.
    - `type` 'web-monitor' | 'person-starting-new-job' | 'linkedin-posts' | 'person-discovery-via-filters' | 'job-postings' | 'job-posting-in-location' | 'first-person-hired-in-company-department' | 'first-person-hired-internationally' | 'company-headcount-growth' | 'company-headcount-growth-over-baseline' | 'company-department-headcount' | 'company-employee-job-location-in-two-countries' | 'funding-announcements' | 'people-watcher' | 'companies-watcher' | 'job-changes-watcher' | 'linkedin-profile' | 'linkedin-post' | 'null', nullable, required: The public agent kind — the same slug you POST to at /business/agents/{type}. null for a legacy kind this API no longer offers.
    - `name` string, required: The agent's name, which is also the name of the results list it delivers into.
    - `status` 'initializing' | 'processing' | 'active' | 'paused' | 'expired' | 'failed' | 'completed' | 'deleted', required: initializing = saved draft, nothing billed; processing = a run is under way; active = running; paused = stopped by you; expired = past its expirationDate; failed = the provider setup failed. Older agents can also read `completed` (a one-off scrape that has finished) and `deleted` (an agent deleted before deletions were timestamped: still readable, but it can no longer be edited or activated).
    - `entityType` 'person' | 'company', required: What the agent delivers into its results list: people or companies.
    - `listId` string, nullable, required: The results list this agent delivers into; read the delivered rows with the Lists endpoints. null while the agent is still a draft.
    - `sourceListIds` string[], required: Watcher kinds only: the existing lists being watched. Empty for every other kind.
    - `contactsFound` integer, required: How many results the agent has delivered into its list so far.
    - `maxContacts` integer, nullable, required: The delivery cap set at creation, or null for no cap.
    - `expirationDate` string, nullable, required: ISO-8601 timestamp at which the agent stops running, or null when it runs until paused or deleted.
    - `folderId` string, nullable, required: The agent folder this agent sits in, or null when it is unfiled.
    - `createdAt` string, required: ISO-8601 creation timestamp. Agents are returned newest-created first.
    - `updatedAt` string, required: ISO-8601 timestamp of the last change to the agent.
  - `pagination` object, required
    - `pageNum` integer, required: The page this answer represents (1-based).
    - `totalPages` integer, required: How many pages exist at the current `limit`.
    - `totalRecords` integer, required: Total agents the token owner has.

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)