> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Transition History

> Get transition history for multiple applications at once

## Bulk Get Application Transition History

Retrieve the transition history of multiple applications in a single request.

### Endpoint

```
POST /external/v1/applications/bulk_transition_history/
```

### Authentication

> \[!NOTE]
> Requires a valid company API key in the `Authorization` header (format: `Api-Key <key>`).

### Request Body

| Field             | Type             | Required | Description                                                 |
| ----------------- | ---------------- | -------- | ----------------------------------------------------------- |
| `application_ids` | array of strings | Yes      | A list of application IDs to fetch transition histories for |

### Example Request

```bash theme={null}
curl -X POST "https://api.firstwork.com/external/v1/applications/bulk_transition_history/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "application_ids": ["uuid-1", "uuid-2", "uuid-3"]
  }'
```

### Responses

#### 200: OK

Successfully retrieved transition histories for the specified applications.

#### 400: Bad Request

Invalid request or missing required fields (e.g., `application_ids`).

#### 500: Internal Server Error

Internal server error while fetching transition histories.