---
title: List child executions of a batch — GET /api/v1/batches/{id}/executions
description: "Child rows ordered by row_index. Tokens with executions:read:full additionally receive applicant_name and applicant_email. Requires executions:read."
canonical_url: "https://cascades.crscreditapi.com/docs/api/batches/list-batch-executions"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#listBatchExecutions"
---

# List child executions of a batch — GET /api/v1/batches/{id}/executions

`GET https://cascades.crscreditapi.com/api/v1/batches/{id}/executions`

- Operation id: `listBatchExecutions`
- Scopes: `executions:read`
- Idempotent: no
- OpenAPI: https://cascades.crscreditapi.com/openapi.json · https://cascades.crscreditapi.com/openapi.yaml (operationId `listBatchExecutions`)

Child rows ordered by `row_index`. Tokens with `executions:read:full`
additionally receive `applicant_name` and `applicant_email`.
Requires `executions:read`.

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | integer | yes | Batch id. Scoped to the calling api_client; a foreign id returns 404. |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `page` | integer | no | 1-based page number. |
| `per_page` | integer | no | Items per page. Values above 100 are clamped to 100. |
| `filter[status]` | string | no | CSV of execution statuses |

## Responses

### 200 — Child execution list (row_index ordered)

`application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of BatchExecutionRow | no |  |
|   `id` | integer | no |  |
|   `object` | string | no |  |
|   `batch_execution_id` | integer | no |  |
|   `workflow_id` | integer | no |  |
|   `row_index` | integer | no | 0-based position in the submitted `rows` array. |
|   `status` | string | no | Lifecycle of an execution. `queued` (batch rows not yet dispatched), `pending`, `running` and `waiting` (paused on a Wait node or adverse-action waiting period) are in flight; `awaiting_review` is paused on human review; `completed`, `failed`, `cancelled` and `skipped` are terminal. One of: `"queued"`, `"pending"`, `"running"`, `"waiting"`, `"awaiting_review"`, `"completed"`, `"failed"`, `"cancelled"`, `"skipped"`. |
|   `retry_count` | integer | no |  |
|   `external_reference` | string, nullable | no |  |
|   `needs_human_review` | boolean | no |  |
|   `review_status` | string | no |  One of: `"none"`, `"in_review"`, `"approved"`, `"denied"`. |
|   `started_at` | string (date-time), nullable | no |  |
|   `completed_at` | string (date-time), nullable | no |  |
|   `created_at` | string (date-time) | no |  |
|   `applicant_name` | string, nullable | no | Only with `executions:read:full`. |
|   `applicant_email` | string, nullable | no | Only with `executions:read:full`. |
| `meta` | Meta | no |  |
|   `request_id` | string | yes | Correlation id for this request. Also sent as the `X-Request-Id` response header; quote it when contacting support. |
|   `page` | integer | yes |  |
|   `per_page` | integer | yes |  |
|   `total_count` | integer | yes |  |
|   `total_pages` | integer | yes |  |
|   `object` | string | yes | The object type of every item in `data`. |

```json
{
  "data": [
    {
      "id": 1,
      "object": "execution",
      "batch_execution_id": 1,
      "workflow_id": 1,
      "row_index": 1,
      "status": "queued",
      "retry_count": 1,
      "external_reference": "string",
      "needs_human_review": true,
      "review_status": "none",
      "started_at": "2026-05-08T18:41:05Z",
      "completed_at": "2026-05-08T18:41:05Z",
      "created_at": "2026-05-08T18:41:05Z",
      "applicant_name": "string",
      "applicant_email": "string"
    }
  ],
  "meta": {
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "page": 1,
    "per_page": 25,
    "total_count": 142,
    "total_pages": 6,
    "object": "execution"
  }
}
```

### 401 — Missing, malformed, expired or revoked bearer token. The `WWW-Authenticate` header carries the RFC 6750 challenge.

`application/json` — `ErrorEnvelope`

```json
{
  "error": {
    "code": "unauthorized",
    "message": "A valid bearer token is required.",
    "details": [],
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/unauthorized"
  }
}
```

### 403 — Token does not hold the required scope. `details` lists the scope(s) that were checked.

`application/json` — `ErrorEnvelope`

```json
{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the required scope.",
    "details": [
      {
        "field": "scope",
        "message": "executions:write"
      }
    ],
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/insufficient_scope"
  }
}
```

### 404 — Resource does not exist or belongs to another tenant / api_client

`application/json` — `ErrorEnvelope`

```json
{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found.",
    "details": [],
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/not_found"
  }
}
```

### 422 — Request body or params failed validation

`application/json` — `ErrorEnvelope`

```json
{
  "error": {
    "code": "validation_failed",
    "message": "The request could not be processed.",
    "details": [
      {
        "field": "execution_mode",
        "message": "must be test or live"
      }
    ],
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/validation_failed"
  }
}
```

### 429 — Rate limit exceeded (60 req/min per IP on `/api/v1`, 600 req/hour
per token prefix, or 300 req/5 min per IP globally). The body is the
standard error envelope and `Retry-After` gives the seconds until
the window resets.


`application/json` — `ErrorEnvelope`

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry later.",
    "details": [],
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
    "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/rate_limited"
  }
}
```

## Code samples

### cURL

```shell
curl "https://cascades.crscreditapi.com/api/v1/batches/77/executions" \
  -H "Authorization: Bearer {{API_KEY}}"
```

### Node.js

```javascript
const response = await fetch("https://cascades.crscreditapi.com/api/v1/batches/77/executions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer {{API_KEY}}"
  }
});

const { data, meta } = await response.json();
console.log(response.status, data, meta.request_id);
```

### Python

```python
import requests

response = requests.get(
    "https://cascades.crscreditapi.com/api/v1/batches/77/executions",
    headers={
        "Authorization": "Bearer {{API_KEY}}",
    },
)
response.raise_for_status()
payload = response.json()
print(payload["data"], payload["meta"]["request_id"])
```

### Ruby

```ruby
require "net/http"
require "json"

uri = URI("https://cascades.crscreditapi.com/api/v1/batches/77/executions")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer {{API_KEY}}"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end
payload = JSON.parse(response.body)
puts payload["data"], payload.dig("meta", "request_id")
```

### Go

```go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://cascades.crscreditapi.com/api/v1/batches/77/executions", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer {{API_KEY}}")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	out, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(out))
}
```

### Agent

```shell
claude mcp add cascades \
  -e CASCADES_API_KEY={{API_KEY}} \
  -e CASCADES_PROD_BASE_URL=https://cascades.crscreditapi.com \
  -- npx -y @crscreditapi/cascades-mcp-server

# Then ask your assistant:
#   "List child executions of a batch 77 using the Cascades API."
# No MCP tool covers this endpoint yet; the assistant can call GET /batches/{id}/executions with curl.
```

## Related

- [Batches](https://cascades.crscreditapi.com/docs/concepts/batches)

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.