---
title: "Returns a list of orchestrator nodes."
method: GET
path: "/api/v1/orchestrator/nodes"
tags: ["Orchestrator"]
---

# Returns a list of orchestrator nodes.

`GET /api/v1/orchestrator/nodes`

Returns a list of orchestrator nodes.

## Query parameters

- `limit` integer
- `next_token` string
- `reverse` boolean
- `order_by` string
- `filter_approval` string
- `filter-status` string

## Response `200`

OK

- ApimodelsListNodesResponse
  - `NextToken` string
  - `Nodes` ModelsNodeState[]
    - `Connection` ModelsNodeConnectionState
      - `connection` 0 | 1
    - `ConnectionState` ModelsConnectionState
      - `ConnectedSince` string — Connection tracking
      - `DisconnectedSince` string
      - `LastComputeSeqNum` integer — Message sequencing for reliable delivery
      - `LastError` string
      - `LastHeartbeat` string — Last successful heartbeat timestamp
      - `LastOrchestratorSeqNum` integer — Last seq received from orchestrator
      - `Status` ModelsNodeConnectionState
        - `connection` 0 | 1
    - `Info` ModelsNodeInfo
      - `BacalhauVersion` ModelsBuildVersionInfo
        - `BuildDate` string
        - `GOARCH` string
        - `GOOS` string
        - `GitCommit` string
        - `GitVersion` string
        - `Major` string
        - `Minor` string
      - `ComputeNodeInfo` ModelsComputeNodeInfo
        - `AvailableCapacity` ModelsResources
          - `CPU` number — CPU units
          - `Disk` integer — Disk in bytes
          - `GPU` integer — GPU units
          - `GPUs` ModelsGPU[] — GPU details
            - `index` integer — Self-reported index of the device in the system
            - `memory` integer — Total GPU memory in mebibytes (MiB)
            - `name` string — Model name of the GPU e.g. Tesla T4
            - `pciaddress` string — PCI address of the device, in the format AAAA:BB:CC.C Used to discover the correct device rendering cards
            - `vendor` 'NVIDIA' | 'AMD/ATI' | 'Intel'
          - `Memory` integer — Memory in bytes
        - `EnqueuedExecutions` integer
        - `ExecutionEngines` string[]
        - `MaxCapacity` ModelsResources
          - `CPU` number — CPU units
          - `Disk` integer — Disk in bytes
          - `GPU` integer — GPU units
          - `GPUs` ModelsGPU[] — GPU details
            - `index` integer — Self-reported index of the device in the system
            - `memory` integer — Total GPU memory in mebibytes (MiB)
            - `name` string — Model name of the GPU e.g. Tesla T4
            - `pciaddress` string — PCI address of the device, in the format AAAA:BB:CC.C Used to discover the correct device rendering cards
            - `vendor` 'NVIDIA' | 'AMD/ATI' | 'Intel'
          - `Memory` integer — Memory in bytes
        - `MaxJobRequirements` ModelsResources
          - `CPU` number — CPU units
          - `Disk` integer — Disk in bytes
          - `GPU` integer — GPU units
          - `GPUs` ModelsGPU[] — GPU details
            - `index` integer — Self-reported index of the device in the system
            - `memory` integer — Total GPU memory in mebibytes (MiB)
            - `name` string — Model name of the GPU e.g. Tesla T4
            - `pciaddress` string — PCI address of the device, in the format AAAA:BB:CC.C Used to discover the correct device rendering cards
            - `vendor` 'NVIDIA' | 'AMD/ATI' | 'Intel'
          - `Memory` integer — Memory in bytes
        - `Publishers` string[]
        - `QueueCapacity` ModelsResources
          - `CPU` number — CPU units
          - `Disk` integer — Disk in bytes
          - `GPU` integer — GPU units
          - `GPUs` ModelsGPU[] — GPU details
            - `index` integer — Self-reported index of the device in the system
            - `memory` integer — Total GPU memory in mebibytes (MiB)
            - `name` string — Model name of the GPU e.g. Tesla T4
            - `pciaddress` string — PCI address of the device, in the format AAAA:BB:CC.C Used to discover the correct device rendering cards
            - `vendor` 'NVIDIA' | 'AMD/ATI' | 'Intel'
          - `Memory` integer — Memory in bytes
        - `RunningExecutions` integer
        - `StorageSources` string[]
        - `address` string — Address is the network location where this compute node can be reached Format: IPv4 or hostname (e.g., "192.168.1.100" or "node1.example.com")
      - `Labels` object
      - `NodeID` string
      - `NodeType` 0 | 1 | 2
      - `SupportedProtocols` ModelsProtocol[] — SupportedProtocols indicates which communication protocols this node supports
    - `Membership` ModelsNodeMembershipState
      - `membership` 0 | 1 | 2 | 3

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/bacalhau-project/apis/bacalhau-api.md) · [All operations](https://skmtc.net/bacalhau-project/apis/bacalhau-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bacalhau-project/bacalhau-api/versions/9470ca2a198b/schema)