---
title: "List available Datadog Agent versions"
method: GET
path: "/api/v2/fleet/agent_versions"
tags: ["Fleet Automation"]
---

# List available Datadog Agent versions

`GET /api/v2/fleet/agent_versions`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/fleet/agent_versions`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/fleet/agent_versions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the list of Datadog Agent versions available for deployment.

Returns `200` with an empty `data` array if the Agent package exists in the catalog
but has no available versions, and `404` only if the Agent package itself is absent
from the catalog.

## Response `200`

OK

- FleetAgentVersionsV2Response: Response containing a list of available Datadog Agent versions.
  - `data` FleetAgentVersionV2[], required: Array of available agent versions.
    - `attributes` FleetAgentVersionV2Attributes, required: Attributes of an available Datadog Agent version.
      - `version` string: The agent version string.
    - `id` string, required: The agent version string used as the unique identifier.
    - `type` 'agent_version', required: The type of the agent version resource.
  - `meta` FleetAgentVersionsV2ResponseMeta: Metadata for the v2 list of agent versions.
    - `page` FleetAgentVersionsV2Page: Pagination details for the v2 list of agent versions.
      - `total_count` integer: Total number of available agent versions.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)