---
title: "List Agent Team Runs"
method: GET
path: "/agent/v1/agent-teams/{agentTeamId}/runs"
tags: ["Agent Teams"]
---

# List Agent Team Runs

`GET /agent/v1/agent-teams/{agentTeamId}/runs`

## Request

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

Fetch all runs for an Agent Team.

Do not use this endpoint to poll for the status of an Agent Team run, for that please use
[Get Agent Team Results](ref:agentteamscontroller_getagentteamrun). The list of Agent Team runs
will always return sorted in reverse chronological order.

## Path parameters

- `agentTeamId` string, required

## Query parameters

- `page[size]` integer
- `page[number]` integer

## Response `200`

Success

- AgentTeamRunsListResponse: Response containing a list of Agent Team runs.
  - `data` AgentTeamRun[], 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` AgentTeamRunAttributes, required: Attributes describing an Agent Team run
      - `agentTeamId` string, required: The unique identifier of the Agent Team associated with this run.
      - `status` 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'STOPPING', required: Lifecycle states for an Agent Team run.
      - `inputs` AgentTeamInput[]: The inputs provided for this run of the Agent Team
        - `name` string, required: Name of the Agent Team input.
        - `value` string, required: Value supplied for the input.
      - `output` string: Final or in-progress output for the Agent Team run. This field is omitted for runs that have not yet produced output.
    - `meta` AgentTeamRunMeta: Metadata information for an Agent Team run
      - `createdAt` string, date-time, required: The UTC date time when the Agent Team run was created
      - `createdBy` integer, required: The id of the user that executed this Agent Team run
      - `updatedAt` string, date-time, required: The UTC date time when the Agent Team run was last updated
      - `completedAt` string, date-time: The UTC date time when the Agent Team run completed
      - `totalCredits` integer: The total number of credits consumed by this Agent Team run. This value is only provided after the Agent Team has successfully finished executing
  - `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
- `404`: Not Found
- `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)