---
title: "Returns the info of the node."
method: GET
path: "/api/v1/agent/node"
tags: ["Ops"]
---

# Returns the info of the node.

`GET /api/v1/agent/node`

## Response `200`

OK

- 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

## Other responses

- `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/revisions/9470ca2a198b/schema)
