List Agents

get

https://api.zoominfo.com/gtm/agent/v1/agents

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 to review its required inputs and supported capabilities.

Per Credit Usage and Limits, this endpoint does not consume credits.

Query Params

filter[name]

string

Filter agents by name (case-insensitive substring match).

filter[tags]

string

Filter agents by tag name, as a comma-separated list (e.g. sales,enrichment). Returns agents carrying at least one of the given tags.

filter[managedBy]

string

enum

Filter agents by operator.

Show Details

ZOOMINFO	Created, hosted, and operated by ZoomInfo.
TENANT	Configured by the customer (Agent Teams); scoped to the owning tenant.

Allowed:

filter[executionMode]

string

enum

Filter agents by supported execution mode.

Show Details

SYNC	The connection is held until the run completes or the synchronous window elapses; an in-progress run is returned on expiry.
STREAMING	Server-sent events streamed as the run progresses.
ASYNC	Submit and receive the in-progress run at once; retrieve the outcome via Get Agent Run. Available for every agent that supports synchronous execution.

Allowed:

page[size]

int32

1 to 100

The number of agents to return per page. Allowable values are between 1 and 100. Defaults to 25.

page[after]

string

Opaque cursor from the previous page's links.next. Omit to fetch the first page.

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/vnd.api+json

200Success

400Bad Request

401Unauthorized

403Forbidden

429Too Many Requests