---
title: "List Nodes"
method: GET
path: "/nodes"
tags: ["Nodes"]
---

# List Nodes

`GET /nodes`

## Request

- Base URL: `https://api.bunny.net/mc`
- URL: `https://api.bunny.net/mc/nodes`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/magic-containers-api/docs/nodes/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all node IP addresses in the Magic Containers network.

## Query parameters

- `nextCursor` string
- `limit` integer

## Response `200`

Nodes were successfully retrieved.

- ListNodesResponse
  - `items` string[]
  - `meta` ListMeta
    - `totalItems` integer
  - `cursor` string, nullable

## Other responses

- `500`: Unexpected server error.

## Changes

- **2026-04-26** `62fb48c758fb`: 4 info
  - added the optional property `id` to the response with the `500` status (media type: application/json)
  - added the optional property `id` to the response with the `500` status (media type: text/plain)
  - the response property `errors/items/message` became required for the status `500` (media type: application/json)
  - the response property `errors/items/message` became required for the status `500` (media type: text/plain)

[Operation history](https://skmtc.dev/bunny/apis/magic-containers-api/changes/nodes/get.md)

---

[API](https://skmtc.dev/bunny/apis/magic-containers-api.md) - [All operations](https://skmtc.dev/bunny/apis/magic-containers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/magic-containers-api/revisions/7bb58a0591b0?raw)