---
title: "List the models your account may use"
method: GET
path: "/models"
tags: ["Models"]
---

# List the models your account may use

`GET /models`

## Request

- Base URL: `https://app.vulk.dev/api/v1`
- URL: `https://app.vulk.dev/api/v1/models`
- Auth: HTTP bearer

Scope `projects.read`. Sending a `locked` model to POST /projects answers 402.

## Response `200`

The models, as the editor's picker shows them.

- ModelList
  - `models` Model[], required
    - `id` string, required: The value for `model` in POST /projects.
    - `name` string, required
    - `description` string
    - `provider` string
    - `group` string
    - `credits` number
    - `inputs` string[]
    - `locked` boolean, required
    - `lockReason` string, nullable
    - `requiredPlan` string, nullable
  - `count` integer, required

## Other responses

- `401`: No key, a malformed key, or a revoked or expired one (code UNAUTHORIZED).
- `403`: The key lacks the scope the endpoint needs (code FORBIDDEN).
- `429`: Over 60 requests in a minute; wait `retryAfter` seconds (code RATE_LIMITED).

---

[API](https://skmtc.dev/vulk/apis/vulk-rest-api.md) · [All operations](https://skmtc.dev/vulk/apis/vulk-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vulk/apis/vulk-rest-api/revisions/b30510c5149c?raw)