---
title: "List one page of one machine's AI models"
method: GET
path: "/api/nodes/{node_id}/models"
tags: ["nodes"]
---

# List one page of one machine's AI models

`GET /api/nodes/{node_id}/models`

## Request

- Base URL: `https://app.nerdit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.nerdit.ai/api/nodes/{node_id}/models`
- Auth: none declared

## Path parameters

- `node_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- NodeModelsView: One page of the machine's models, newest first.
  - `items` NodeModelView[], required
    - `id` string, required
    - `name` string, required
    - `model` string, nullable
    - `backend` string, nullable
    - `status` string, required
    - `desired_state` string, nullable
    - `model_pulled` boolean
    - `gpu_count` integer
    - `gpu_ids` string[]
    - `gpu_utilization` object
    - `max_model_len` integer, nullable
    - `gpu_memory_utilization` number, nullable
    - `created_at` string, date-time, required
  - `next_cursor` string, nullable, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Content
- `502`: Bad Gateway

---

[API](https://skmtc.dev/nerdit/apis/nerdit-cloud-web.md) · [All operations](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/llms.txt) · [OpenAPI document](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/revisions/06e3b44b58be?raw)