ZOzoominfo
Agents

List 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.

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

Query parameters

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]'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 agents by operator.

filter[executionMode]'SYNC' | 'STREAMING' | 'ASYNC'

Execution modes an agent supports.

Filter agents by supported execution mode.

page[size]integer

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.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.