> ## 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.

# List Applications

> Retrieve a paginated list of applications with optional filters

## List Applications

Retrieve a paginated list of applications belonging to the authenticated company.

### Endpoint

```
GET /external/v1/applications/
```

### Authentication

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

### Query Parameters

| Parameter         | Type              | Required | Description                                               |
| ----------------- | ----------------- | -------- | --------------------------------------------------------- |
| `flow_id`         | string (UUID)     | Yes      | Filter by a specific flow ID (must belong to the company) |
| `current_stage`   | string (UUID)     | No       | Filter by the ID of the application's current page stage  |
| `page`            | integer           | No       | Page number (1-based). Defaults to 1                      |
| `page_size`       | integer           | No       | Items per page. Defaults to 50                            |
| `created__gt`     | string (ISO 8601) | No       | Applications created after this datetime                  |
| `created__gte`    | string (ISO 8601) | No       | Applications created on or after this datetime            |
| `created__lt`     | string (ISO 8601) | No       | Applications created before this datetime                 |
| `created__lte`    | string (ISO 8601) | No       | Applications created on or before this datetime           |
| `updated_at__gt`  | string (ISO 8601) | No       | Applications updated after this datetime                  |
| `updated_at__gte` | string (ISO 8601) | No       | Applications updated on or after this datetime            |
| `updated_at__lt`  | string (ISO 8601) | No       | Applications updated before this datetime                 |
| `updated_at__lte` | string (ISO 8601) | No       | Applications updated on or before this datetime           |

### Example Request

```bash theme={null}
curl -X GET "https://api.firstwork.com/external/v1/applications/?flow_id=550e8400-e29b-41d4-a716-446655440000&page=1&page_size=50" \
  -H "Authorization: Api-Key YOUR_API_KEY"
```

### Responses

#### 200: OK

Paginated list of applications' attributes.

#### 400: Bad Request

Missing/invalid parameters or invalid datetime format.

#### 500: Internal Server Error

Unexpected error.

### Notes

* All datetime values must be ISO 8601 strings (`YYYY-MM-DDTHH:MM:SSZ`)
* If no timezone is provided, the server assumes its default timezone
* Results are ordered by most recent first
* For advanced filtering with OG variable support, see the [v2 endpoint](/api-reference/endpoints/list-applications-v2)