---
title: "List Model Specs"
method: GET
path: "/v1/model-specs/"
tags: ["v1", "protected", "model-specs"]
---

# List Model Specs

`GET /v1/model-specs/`

List model specifications with optional filtering.

## Query parameters

- `provider_spec_id` string, uuid, nullable
- `is_active` boolean, nullable

## Response `200`

Successful Response

- AgentareaApiApiV1ModelSpecsModelSpecResponse[]
  - `context_window` integer, required
  - `created_at` string, required
  - `default_context_strategy` string, nullable, required
  - `description` string, nullable, required
  - `display_name` string, required
  - `id` string, required
  - `input_cost_per_token` number, nullable
  - `is_active` boolean, required
  - `max_output_tokens` integer, nullable
  - `model_name` string, required
  - `output_cost_per_token` number, nullable
  - `provider_key` string, nullable
  - `provider_name` string, nullable
  - `provider_spec_id` string, required
  - `supports_function_calling` boolean, nullable
  - `supports_reasoning` boolean, nullable
  - `supports_vision` boolean, nullable
  - `updated_at` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-30** `ce40e8663ec3` — 3 info
  - the `input_cost_per_token` response's property default value `0` was removed for the status `200`
  - the `max_output_tokens` response's property default value `4096` was removed for the status `200`
  - the `output_cost_per_token` response's property default value `0` was removed for the status `200`
- **2026-07-08** `8940d7f77282` — 2 breaking
  - the `items/created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/updated_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
- **2026-04-29** `e1a530c0a2d5` — 6 info
  - added the optional property `items/input_cost_per_token` to the response with the `200` status
  - added the optional property `items/max_output_tokens` to the response with the `200` status
  - added the optional property `items/output_cost_per_token` to the response with the `200` status
  - added the optional property `items/supports_function_calling` to the response with the `200` status
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/model-specs/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/42240c74704e/schema)