---
title: "Read the hiring settings"
method: GET
path: "/hiring/settings"
tags: ["hiring"]
---

# Read the hiring settings

`GET /hiring/settings`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/hiring/settings`
- Auth: HTTP bearer

The candidate email templates, how long decided applications are kept, how long other-roles consent lasts, and your own booking link.

## Response `200`

The result.

- object
  - `templates` object, required
    - `received` object, required
      - `subject` string, required
      - `body` string, required
    - `next_step` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_applied` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_interview` object, required
      - `subject` string, required
      - `body` string, required
  - `variables` string[], required
  - `booking_link` string, nullable, required
  - `from` object, required
    - `name` string, required
    - `company` string, required
    - `reply_to` string, required
  - `retention_months` integer, required
  - `other_roles_months` integer, required
  - `careers_intro` string, nullable, required
  - `privacy_notice_url` string, nullable, required
  - `scanner` boolean, required
  - `writer` string, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)