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

# Get Hiring Flow

> Retrieve detailed information about a specific hiring flow

## Get Hiring Flow Details

Retrieve detailed information about a specific hiring flow, including its company, legal entity, stages, forms, and form elements.

### Endpoint

```
GET /external/v1/hiring-flow/{hiring_flow_id}/
```

### Authentication

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

### Path Parameters

| Parameter        | Type          | Required | Description        |
| ---------------- | ------------- | -------- | ------------------ |
| `hiring_flow_id` | string (UUID) | Yes      | The hiring flow ID |

### Query Parameters

| Parameter        | Type          | Required | Description                       |
| ---------------- | ------------- | -------- | --------------------------------- |
| `hiring_flow_id` | string (UUID) | Yes      | ID of the hiring flow to retrieve |

### Example Request

```bash theme={null}
curl -X GET "https://api.firstwork.com/external/v1/hiring-flow/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
```

### Responses

#### 200: OK

Detailed hiring flow information including nested company, forms, stages, and OG variables.

#### 400: Bad Request

Hiring flow not found or not associated with the company.