List child executions of a batch

GET /api/v1/batches/{id}/executions

executions:read

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	Description
`id`required	integer	Batch id. Scoped to the calling api_client; a foreign id returns `404`.

Query parameters

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

Responses

200 Child execution list (row_index ordered) application/json
- data array of BatchExecutionRow
  
  id integer
  
  object string
  
  batch_execution_id integer
  
  workflow_id integer
  
  row_index integer 0-based position in the submitted `rows` array.
  
  status string 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
  
  external_reference string, nullable
  
  needs_human_review boolean
  
  review_status string One of none in_review approved denied
  
  started_at string (date-time), nullable
  
  completed_at string (date-time), nullable
  
  created_at string (date-time)
  
  applicant_name string, nullable Only with `executions:read:full`.
  
  applicant_email string, nullable Only with `executions:read:full`.
- meta Meta
  
  Schema: PaginatedMeta
  
  request_id string required Correlation id for this request. Also sent as the `X-Request-Id` response header; quote it when contacting support.
  
  page integer required
  
  per_page integer required
  
  total_count integer required
  
  total_pages integer required
  
  object string required The object type of every item in `data`.
200 example
```
{
  "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

Schema: ErrorEnvelope

401 example

{
  "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

Schema: ErrorEnvelope

403 example

{
  "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

Schema: ErrorEnvelope

404 example

{
  "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

Schema: ErrorEnvelope

422 example

{
  "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

Schema: ErrorEnvelope

429 example

{
  "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"
  }
}

Markdown version · OpenAPI

Path parameters

Query parameters

Responses

Related