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

# Get Agent Team Results

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

## Request

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

Retrieves the current status and available output for a previously started Agent Team run.

Poll this endpoint after executing an Agent Team run to check the status of that Agent Team.
Returns `404` when the Agent Team or run does not exist, or if the run does not belong to the
specified Agent Team.

## Path parameters

- `agentTeamId` string, required
- `runId` string, required

## Response `200`

Success

- AgentTeamRunResponse: Response containing a single Agent Team run.
  - `data` AgentTeamRun, required: Model describing an Agent Team run
    - `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

## Other responses

- `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)