---
title: "Get Agent Track History"
method: GET
path: "/v1/agents/releases"
tags: ["Agents"]
---

# Get Agent Track History

`GET /v1/agents/releases`

## Request

- Base URL: `https://eu1.api.matillion.com/dpc`
- URL: `https://eu1.api.matillion.com/dpc/v1/agents/releases`
- Auth: HTTP bearer

Returns a paginated list of agent version track history entries. Results can be filtered by track name, support level, version, or release date range.

## Query parameters

- `trackName` string
- `supportLevel` string
- `version` string
- `releasedBefore` string
- `releasedAfter` string
- `page` unknown
- `size` unknown

## Response `200`

Success

- AgentTrackHistoryResponse
  - `page` integer: The 0-indexed page number of the returned results.
  - `results` AgentTrackHistory[]: List of agent track history entries for the current page
    - `releasedAt` string: The ISO 8601 timestamp when this version was released on the track
    - `supportLevel` string: The support level for this entry, uppercase (e.g. SUPPORTED, UNSUPPORTED, DEPRECATED)
    - `trackName` string: The name of the track, uppercase (e.g. CURRENT, STABLE)
    - `version` string: The agent version string for this history entry
  - `size` integer: The size of each page of results.
  - `total` integer: Total number of available results across all pages.

## Other responses

- `400`: Wrong request parameters used
- `403`: Forbidden
- `500`: Unexpected error occurred

---

[API](https://skmtc.dev/maia/apis/maia-public-rest-api.md) - [All operations](https://skmtc.dev/maia/apis/maia-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maia/apis/maia-public-rest-api/revisions/6239825f68eb?raw)