Skip to main content
GET
/
api
/
v2
/
public
/
execution
/
:execution_id
/
nodes
/
:node_id
/
batches
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"

{
  "docs": [
    { "batch_index": 0, "status": "Success", "output": { "processed": 50 } }
  ],
  "totalDocs": 1,
  "page": 1,
  "limit": 10,
  "hasNextPage": false
}
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
​
x-api-key
string
Your Refold API key.
​
linked_account_id
string
The linked account.
Option 2 — Session token
​
Authorization
string
Session token. Format: Bearer YOUR_SESSION_TOKEN

​
Path Parameters

​
execution_id
string
required
The execution ID.
​
node_id
string
required
The node ID (from the execution’s nodes array).

​
Query Parameters

​
status
string
Filter batches by status.
​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Page size.

​
Response

Returns a paginated list of batch results for the node.
{
  "docs": [
    { "batch_index": 0, "status": "Success", "output": { "processed": 50 } }
  ],
  "totalDocs": 1,
  "page": 1,
  "limit": 10,
  "hasNextPage": false
}

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"