---
title: "List models; the base model needle-3 comes first"
method: GET
path: "/models"
---

# List models; the base model needle-3 comes first

`GET /models`

## Request

- Base URL: `https://cactuscompute.com/v1`
- URL: `https://cactuscompute.com/v1/models`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `after` string
- `search` string

## Response `200`

Models

- object
  - `object` 'list', required
  - `data` Model[], required
    - `id` string, required
    - `object` 'model', required
    - `owned_by` string, required
    - `name` string, nullable
    - `depth` integer, required: Layers
    - `bytes` integer
    - `created_at` integer: Unix seconds
    - `job_id` string
    - `variants` object[], required: Every size this model was exported at; `is_full` marks the one equal to max_depth
      - `id` string, required
      - `depth` integer, required
      - `is_full` boolean, required
      - `bytes` integer
  - `has_more` boolean, required
  - `first_id` string
  - `last_id` string

## Other responses

- `4XX`: The request was rejected; `code` says why and `url` (when present) is the console page that clears it

---

[API](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api.md) - [All operations](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api/revisions/227acc9b45e8?raw)