---
title: "Get Hiring Leads"
method: GET
path: "/api/v1/applicant_tracking/hiring_leads"
tags: ["Applicant Tracking", "Public API"]
---

# Get Hiring Leads

`GET /api/v1/applicant_tracking/hiring_leads`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/applicant_tracking/hiring_leads`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/applicant_tracking/hiring_leads/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the list of employees who can be assigned as a hiring lead when creating a new job opening. The authenticated caller must have access to ATS settings. Use the returned `employeeId` values as the `hiringLead` field when calling the Create Job Opening endpoint.

## Response `200`

Success. Returns an array of employees who can be assigned as hiring leads.

- object[]
  - `employeeId` integer: The internal employee ID to use as the `hiringLead` value in the Create Job Opening request
  - `preferredFullName` string: The employee's preferred full name

## Other responses

- `401`: Unauthorized. Invalid API credentials.
- `403`: Insufficient user permissions or API access is not turned on.
- `404`: Bad request url.

---

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