---
title: "hiringTeamRole.list"
method: POST
path: "/hiringTeamRole.list"
tags: ["Hiring Team Role"]
---

# hiringTeamRole.list

`POST /hiringTeamRole.list`

Lists the possible hiring team roles in an organization

**Requires the [`organizationRead`](authentication#permissions-hiringteamrolelist) permission.**

## Request body

- HiringTeamRoleListRequest
  - `namesOnly` boolean, required — When set to true (the default), an array of role titles is returned. When set to false, an array of objects that include the id and title of the role is returned.

## Response `200`

Responses from the hiringTeamRole.list endpoint

- union
  - HiringTeamRoleListSuccessResponse
    - `success` true, required
    - `results` union, required
      - string[]
      - HiringTeamRoleSummary[]
        - `id` string, uuid, required — The unique identifier for the hiring team role
        - `title` string, required — The title of the hiring team role
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)