---
title: "List Provider Specs With Models"
method: GET
path: "/v1/provider-specs/with-models"
tags: ["v1", "protected", "provider-specs"]
---

# List Provider Specs With Models

`GET /v1/provider-specs/with-models`

List all provider specifications with their available models.

## Query parameters

- `is_builtin` boolean, nullable

## Response `200`

Successful Response

- ProviderSpecWithModelsResponse[]
  - `created_at` string, required
  - `description` string, nullable, required
  - `icon` string, nullable, required
  - `icon_url` string, nullable, required
  - `id` string, required
  - `is_builtin` boolean, required
  - `models` AgentareaApiApiV1ProviderSpecsModelSpecResponse[], required
    - `context_window` integer, required
    - `created_at` string, 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_spec_id` string, required
    - `supports_function_calling` boolean, nullable
    - `supports_reasoning` boolean, nullable
    - `supports_vision` boolean, nullable
    - `updated_at` string, required
  - `name` string, required
  - `provider_key` string, required
  - `provider_type` string, required
  - `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` — 4 breaking
  - the `items/created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/models/items/created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/models/items/updated_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/models/items/input_cost_per_token` to the response with the `200` status
  - added the optional property `items/models/items/max_output_tokens` to the response with the `200` status
  - added the optional property `items/models/items/output_cost_per_token` to the response with the `200` status
  - added the optional property `items/models/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/provider-specs/with-models/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)