---
title: "Get Nodes"
method: GET
path: "/api/nodes"
tags: ["Node"]
---

# Get Nodes

`GET /api/nodes`

Retrieve a list of all nodes. Accessible only to sudo admins.

## Response `200`

Successful Response

- NodeResponse[]
  - `name` string, required
  - `address` string, required
  - `port` integer
  - `api_port` integer
  - `usage_coefficient` number
  - `id` integer, required
  - `xray_version` string, nullable
  - `status` 'connected' | 'connecting' | 'error' | 'disabled', required
  - `message` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/atrvatam/apis/marzbanapi.md) · [All operations](https://skmtc.dev/atrvatam/apis/marzbanapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atrvatam/marzbanapi/revisions/0aa31d6bd001/schema)
