---
title: "List Tuned Models"
method: GET
path: "/agents/{agent_id}/tune/models"
tags: ["/agents/{id}/tune"]
---

# List Tuned Models

`GET /agents/{agent_id}/tune/models`

Retrieves a list of tuned models associated with the specified Agent.

## Path parameters

- `agent_id` string, uuid, required — ID of the Agent from which to retrieve tuned models

## Response `200`

Successful Response

- ListRegisteredModelResponse — Response model to list registered models
  - `models` RegisteredModelResponse[], required — List of registered models for the agent
    - `model_id` string, required — ID of the registered model
    - `job_id` string, uuid, required — ID of the tuning job that produced the model
    - `application_id` string, uuid, required — ID of the associated agent
    - `state` 'active' | 'inactive' | 'pending', required — Enum for the state of the model. Should keep in sync with `frontend/src/types/models.ts`.
    - `created_at` string, date-time, required — Timestamp indicating when the model was created
  - `total_count` integer, required — Total number of models associated with the agent

## Other responses

- `422` — Validation Error

## Changes

- **2025-02-26** `5298551c424b` — 1 breaking, 3 info
  - removed the required property `total` from the response with the `200` status
  - added the required property `models/items/application_id` to the response with the `200` status
  - added the required property `models/items/state` to the response with the `200` status
  - added the required property `total_count` to the response with the `200` status
- **2025-01-15** `4ed32c3243ce` — 1 breaking, 1 warning
  - removed the required property `has_more` from the response with the `200` status
  - removed the optional property `next_after` from the response with the `200` status
- **2025-01-14** `4dd01a1cc34b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/:agent_id/tune/models/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/17bdb8a33fb4/schema)