> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a GPU Node

> Fetch a single GPU node by ID from Aria Compute PIN, including SSH details, labels, status, and agent count.

Retrieve the details for a specific GPU node using its unique identifier. The response includes all SSH connection fields, labels, status, and the current agent count.

## Endpoint

**GET** `/v1/gpu-nodes/:id`

Authorization: Bearer API key required.

## Path parameters

<ParamField path="id" type="string" required>
  GPU node identifier, e.g. gn\_a1b2c3d4.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Node identifier.
</ResponseField>

<ResponseField name="name" type="string" required>
  Node name.
</ResponseField>

<ResponseField name="ip" type="string" required>
  Node IP address.
</ResponseField>

<ResponseField name="ssh_port" type="integer">
  SSH port.
</ResponseField>

<ResponseField name="ssh_user" type="string" required>
  SSH username.
</ResponseField>

<ResponseField name="spec" type="string">
  Hardware or configuration spec.
</ResponseField>

<ResponseField name="labels" type="array of strings">
  Scheduling labels.
</ResponseField>

<ResponseField name="status" type="string">
  Current status, e.g. active.
</ResponseField>

<ResponseField name="agent_count" type="integer">
  Number of deployed agents on this node.
</ResponseField>

<ResponseField name="created_at" type="string (ISO 8601)">
  Creation timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string (ISO 8601)">
  Last update timestamp.
</ResponseField>

## Example

```bash theme={null}
curl -s http://<pin-host>:8001/v1/gpu-nodes/gn_a1b2c3d4 \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "id": "gn_a1b2c3d4",
  "name": "node-01",
  "ip": "10.0.1.10",
  "ssh_port": 22,
  "ssh_user": "ubuntu",
  "spec": "A100-80G x8",
  "labels": ["training", "a100"],
  "status": "active",
  "agent_count": 2,
  "created_at": "2024-05-01T12:00:00Z",
  "updated_at": "2024-05-10T08:30:00Z"
}
```


## Related topics

- [List GPU Nodes](/api-reference/pin/gpu-nodes/list.md)
- [Delete a GPU Node](/api-reference/pin/gpu-nodes/delete.md)
- [Create a GPU Node](/api-reference/pin/gpu-nodes/create.md)
- [Update a GPU Node](/api-reference/pin/gpu-nodes/update.md)
- [Get an Agent](/api-reference/pin/agents/get.md)