---
title: "List Agent Teams"
method: GET
path: "/agent/v1/agent-teams"
tags: ["Agent Teams"]
---

# List Agent Teams

`GET /agent/v1/agent-teams`

## Request

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

Returns a list of Agent Teams. Each Agent Team contains information about the Agent Team including its name, 
the registered triggers that can initiate an Agent Team run, and whether the Agent Team and its triggers are
currently active.

Agent Teams can be run using [Run Agent Team](ref:agentteamscontroller_runagentteam). Any Agent Team can
be executed manually using that endpoint, regardless of whether the Agent Team is marked as active or inactive.
To get additional details for an Agent Team, including the required inputs needed to create a new run, please use
[Get Agent Team Details](ref:agentteamscontroller_getagentteamdetails)

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `sort` string
- `filter[name]` string
- `filter[tags]` string[]

## Response `200`

Success

- AgentTeamsListResponse: Response containing a list of Agent Teams.
  - `data` AgentTeam[], 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` AgentTeamAttributes, required: Public Agent Team details.
      - `name` string, required: Name of the Agent Team.
      - `description` string: Human-readable description of the Agent Team. This field is omitted when no objective or description is defined.
      - `triggers` AgentTeamTriggerType[], required: The trigger types associated with this Agent Team
      - `active` boolean, required: Flag indicating whether the Agent Team's triggers are active or not. Agent Teams that are inactive can still be triggered manually
      - `tags` string[]: The names of the tags associated with this Agent Team.
    - `meta` AgentTeamMeta: Metadata information for an Agent Team
      - `createdAt` string, date-time, required: The timestamp when this Agent Team was created
      - `createdBy` integer, required: The id of the user that created this Agent Team
      - `updatedAt` string, date-time, required: The timestamp for the last time this Agent Team was updated
      - `creditsUsed` integer, required: The total amount of AI Credits consumed by this Agent Team over its lifespan
      - `lastRunDate` string, date-time: The date of the last successful run of this Agent Team
  - `meta` PagingMeta: Metadata for the current page of results.
    - `page` integer, required: The current page of results being returned.
    - `pageSize` integer, required: The page size as specified by the request.
    - `totalCount` integer, required: The total count of results within the current search parameters.
  - `links` PagingLinks: Links describing the available paging options.
    - `first` string, uri: A link to the first page of data
    - `last` string, uri: A link to the last page of data
    - `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)