---
title: "List Agents"
method: GET
path: "/agent/v1/agents"
tags: ["Agents"]
---

# List Agents

`GET /agent/v1/agents`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/agent/v1/agents`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:agent:read`

Lists all agents available to your tenant, including ZoomInfo managed agents
and your tenant's published Agent Teams. Before running an agent, use
[Get Agent Details](ref:agentscontroller_getagent) to review its required
inputs and supported capabilities.

Per [Credit Usage and Limits](doc:credit-usage-and-limits), this endpoint
does not consume credits.

## Query parameters

- `filter[name]` string
- `filter[tags]` string
- `filter[managedBy]` 'ZOOMINFO' | 'TENANT': Who operates the agent. ZoomInfo-managed agents are available to every eligible tenant; tenant agents (customer-built Agent Teams) are visible only within the owning tenant.
- `filter[executionMode]` 'SYNC' | 'STREAMING' | 'ASYNC': Execution modes an agent supports.
- `page[size]` integer
- `page[after]` string

## Response `200`

Success

- AgentsListResponse: Response containing a page of the agent catalog.
  - `data` Agent[], required: The primary data of the document
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AgentAttributes, required: Attributes shared by every agent catalog entry.
      - `name` string, required: Display name of the agent.
      - `description` string, required: What the agent does.
      - `version` string: Semantic version of the agent definition. Omitted when the owning runtime does not version its agents.
      - `iconUrl` string, uri: URL of the agent's icon image.
      - `active` boolean, required: Whether the agent is currently active and runnable.
      - `managedBy` 'ZOOMINFO' | 'TENANT', required: Who operates the agent. ZoomInfo-managed agents are available to every eligible tenant; tenant agents (customer-built Agent Teams) are visible only within the owning tenant.
      - `tags` string[]: Tags assigned to the agent. Customer-assigned for tenant agents; curated defaults for ZoomInfo-managed agents.
      - `capabilities` AgentCapabilities, required: Execution capabilities declared by the agent.
        - `executionModes` AgentExecutionMode[], required: Execution modes this agent supports; each maps to an invocation endpoint.
        - `defaultInputModes` string[], required: MIME types accepted as run input.
        - `defaultOutputModes` string[], required: MIME types the agent can produce.
        - `interactive` boolean: OPTIONAL. Whether the agent can pause awaiting input (`TASK_STATE_INPUT_REQUIRED` / `TASK_STATE_AUTH_REQUIRED`) and be resumed by a follow-up run that sets `taskId`. `false` or absent (the case for every agent today) means runs are single-shot.
    - `meta` AgentMeta: Audit metadata for an agent catalog entry. Creator/modifier fields are present for tenant agents only.
      - `createdAt` string, date-time: When the agent was created.
      - `updatedAt` string, date-time: When the agent definition last changed.
      - `createdBy` string: User id that created the agent (tenant agents).
      - `modifiedBy` string: User id that last modified the agent (tenant agents).
  - `meta` CursorPagingMeta: Metadata for a cursor-paged collection.
    - `page` CursorPageInfo, required: Page details for a cursor-paged collection.
      - `pageSize` integer, required: The page size as specified by the request.
      - `totalCount` integer, required: The total count of results matching the current filters.
  - `links` CursorPagingLinks: Links for a cursor-paged collection. `next` is omitted on the last page and `prev` on the first.
    - `self` string, uri: The link that generated the current response document
    - `prev` string, uri: A link to the previous page of data
    - `next` string, uri: A link to the next page of data

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/agent-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/agent-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/agent-api-v1/revisions/01784a5ae274?raw)