---
title: "Get a list of notebook servers"
method: GET
path: "/notebooks"
tags: ["notebooks"]
---

# Get a list of notebook servers

`GET /notebooks`

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Succeeded. The list of notebooks will be output in descending order of created_at.

- object — Notebooks
  - `data` object, required — page information
    - `items` object[], required
      - `failure_type` 'unknown' | 'not_found' — Notebook server failure type
      - `force_stops_at` string, date-time — Date time when the notebook server will be forced to stop.
      - `id` string, required
      - `image_version` string, required — Notebook server image version
      - `instance` 'medium' | 'large' | 'mediumx2' | 'mediumx2-t4' | 'mediumx2-t4-light-pfp', required — Notebook server instance type
      - `spec` object, required — Spec
        - `cpu` integer, required — Number of cpu
        - `instance` 'medium' | 'large' | 'mediumx2' | 'mediumx2-t4' | 'mediumx2-t4-light-pfp', required — Notebook server instance type
        - `memory_limit_bytes` integer, required — Available memory size (bytes) to user
        - `required_resources` number, required — Required resources
      - `started_at` string, date-time — Date time when the notebook server was started
      - `status` 'initial' | 'starting' | 'waiting' | 'running' | 'stopping' | 'stopped' | 'failed', required — Notebook server status
      - `stopped_at` string, date-time — Date time when the notebook server was stopped
    - `limit` integer, required — number of items
    - `offset` integer, required — offset of items
    - `total` integer, required — total number of items

## Other responses

- `400` — Bad request
- `default` — Other error

---

[API](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api.md) · [All operations](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/matlantis/matlantis-web-ui-backend-api/revisions/b155f3a32673/schema)