> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Node Batches

> List the batches processed by a node in an execution.

List the batches processed by a specific node within an execution, paginated. This applies to **batch nodes** (nodes that iterate over a collection); non-batch nodes return a `501`.

## Authentication

This endpoint is scoped to a linked account, so it accepts **either** authentication method.

**Option 1 — API key**

<ParamField header="x-api-key" type="string">Your Refold API key.</ParamField>
<ParamField header="linked_account_id" type="string">The linked account.</ParamField>

**Option 2 — Session token**

<ParamField header="Authorization" type="string">Session token. **Format:** `Bearer YOUR_SESSION_TOKEN`</ParamField>

## Path Parameters

<ParamField path="execution_id" type="string" required>The execution ID.</ParamField>
<ParamField path="node_id" type="string" required>The node ID (from the execution's `nodes` array).</ParamField>

## Query Parameters

<ParamField query="status" type="string">Filter batches by status.</ParamField>
<ParamField query="page" type="integer" default="1">Page number.</ParamField>
<ParamField query="limit" type="integer" default="10">Page size.</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    Returns a paginated list of batch results for the node.
  </Tab>

  <Tab title="501 Not Implemented">
    Returned when the node is not a batch node (`is_batch: false`).
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error_code" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 theme={null}
  {
    "docs": [
      { "batch_index": 0, "status": "Success", "output": { "processed": 50 } }
    ],
    "totalDocs": 1,
    "page": 1,
    "limit": 10,
    "hasNextPage": false
  }
  ```

  ```json 501 theme={null}
  {
    "status_code": 501,
    "http_error_type": "NOT_IMPLEMENTED",
    "error_code": "SERVER_ERROR",
    "message": "Batch details are not yet available for this execution type"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL (API key) theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/execution/{execution_id}/nodes/{node_id}/batches" \
    -H "x-api-key: YOUR_API_KEY" \
    -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"
  ```

  ```bash cURL (session token) theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/execution/{execution_id}/nodes/{node_id}/batches" \
    -H "Authorization: Bearer YOUR_SESSION_TOKEN"
  ```
</RequestExample>