# GET /v1/models

> The models a deployment may choose from.

In [Account API](https://vestra.ai/developers/reference/api/account.md): Your company's account: who is calling, its keys, its caps, what it spent and the models it may use.

Send `Authorization: Bearer vk_test_...` on every call.

The models a deployment may choose from.

Your API key, scope `runtime` or `all`. On the card: [`keys`](https://vestra.ai/developers/keys.md). Over HTTP it is made from the contract: fill in every value.

## Request

Nothing to send but the route.

## Answers 200

- `data` (`object[]`): The items on this page.
  - `id` (`string`): The model's id: what a deployment's `model` takes.
  - `object` (`"model"`): Always `model`.
  - `label` (`string`): Its name, as a person reads it.
- `next_cursor` (`string | null`): Send it as `cursor` for the next page; null on the last page.

## Code

**HTTP**

```bash
curl "$VESTRA_BASE_URL/v1/models" \
  -H "Authorization: Bearer $VESTRA_API_KEY"
```

**TypeScript, Python, CLI, MCP**: No sample in your language for this route, so here it is over HTTP.
