# Get engagement batch status

**Retrieve the status of an engagement batch**
Returns the current processing status of a previously submitted engagement batch,
along with the IDs of any engagements that have been created so far.
Use this endpoint to poll for completion after calling
`POST /api/v1/engagements/batch/create`.
**Batch statuses:**
- `DRAFT` — batch has been recorded but processing has not started
- `CREATING` — engagements are actively being created
- `CREATED` — all engagements in the batch have been created successfully
- `CANCELED` — the batch was canceled before completion

**Real Example:**

```bash
curl --location 'https://{{host}}/api/v1/engagements/batch/9001/status' \
--header 'Authorization: Bearer {{token}}'
```

Endpoint: GET /api/v1/engagements/batch/{batchId}/status
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `batchId` (integer, required)
    Unique identifier of the engagement batch

## Response 200 fields (application/json):

  - `batchId` (integer)
    Unique identifier of the engagement batch
    Example: 9001

  - `status` (string)
    Current processing status of the batch
    Enum: "DRAFT", "CREATING", "CREATED", "CANCELED"

  - `engagementIds` (array)
    IDs of engagements created by this batch
    Example: [34567,34568]