---
title: BatchCreateRequest schema
description: Fields of the BatchCreateRequest object in the Cascades API.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/BatchCreateRequest"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/BatchCreateRequest"
---

# BatchCreateRequest

Defined in [openapi.json](https://cascades.crscreditapi.com/openapi.json#/components/schemas/BatchCreateRequest) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)).

| Field | Type | Required | Description |
|---|---|---|---|
| `rows` | array of object | yes | One object per applicant. Every row must be an object. |
|   `external_reference` | string | no |  |
|   `applicant` | ApplicantPayload | no | Free-form applicant data forwarded to the workflow's first node as `context.applicant`. Field names depend on the workflow definition. |
| `execution_mode` | string | no |  One of: `"test"`, `"live"`. |
| `external_reference` | string | no |  |

```json
{
  "rows": [
    {
      "external_reference": "string",
      "applicant": {
        "first_name": "Jordan",
        "last_name": "Lee",
        "email": "jordan@example.com",
        "ssn": "123-45-6789",
        "dob": "1989-04-12"
      }
    }
  ],
  "execution_mode": "test",
  "external_reference": "string"
}
```

## Sitemap

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