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

# Get Agent Run Nodes

> Get node-level status details for a run.

Returns node-level status for a run, including node type metadata and whether a node is currently blocked by credits.

## Request

```bash theme={null}
curl -X GET "https://api.mosaic.so/agent_run/[run_id]/nodes" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Response

```json theme={null}
{
  "run_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
  "nodes": [
    {
      "agent_node_id": "11111111-1111-1111-1111-111111111111",
      "original_node_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "status": "failed",
      "status_message": "Insufficient credits",
      "errors": ["Audio transcription timed out after 300s"],
      "node_type": {
        "node_type_id": "3b281fb9-9eb2-40f6-b05b-4b6f909a3da9",
        "node_type_name": "AI Music",
        "docs_url": "https://docs.mosaic.so/tiles/ai-music",
        "params_docs_url": "https://docs.mosaic.so/tiles/ai-music#api-info"
      },
      "needs_credits": true
    }
  ]
}
```

## Response Fields

| Field                      | Type             | Description                                                                                              |
| -------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------- |
| `run_id`                   | `string`         | Agent run ID.                                                                                            |
| `nodes[].agent_node_id`    | `string`         | Runtime node ID for this run.                                                                            |
| `nodes[].original_node_id` | `string \| null` | Template `agent_node_id` this runtime node was cloned from.                                              |
| `nodes[].status`           | `string`         | Current node status.                                                                                     |
| `nodes[].status_message`   | `string \| null` | Optional node status detail.                                                                             |
| `nodes[].errors`           | `array`          | Error messages from failed tasks in this node. Empty array when the node has no errors.                  |
| `nodes[].node_type`        | `object`         | Node type metadata, including docs links.                                                                |
| `nodes[].needs_credits`    | `boolean`        | `true` when any runtime task attached to the node is marked `needs_credits=true` (insufficient credits). |

<Tip>
  When a failed or blocked node has `needs_credits=true`, top up credits and call [Resume Agent Run](/api/agent-runs/post-agent-run-resume) to continue the run.
</Tip>