---
title: "List users"
method: GET
path: "/v3/users"
tags: ["Users"]
---

# List users

`GET /v3/users`

Users are the Greenhouse accounts inside your organization — recruiters, hiring managers, interviewers, coordinators, sourcers, and site admins. Each user has a `primary_email` (sign-in identifier), an optional partner-supplied `employee_id` for HRIS linkage, an activation state (`deactivated`), and a `site_admin` flag indicating unrestricted organization-level access. Use `employee_ids`, `primary_email`, or `external_office_id`/`external_department_id` to look up users by external identifiers without an extra id round-trip. Integration system users (ISUs) and other service accounts are hidden by default — pass `show_service_accounts=true` to include them.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `agency_ids` integer[]
- `office_ids` integer[]
- `department_ids` integer[]
- `linked_candidate_ids` integer[]
- `interviewer_tag_ids` integer[]
- `fields` string[]
- `employee_ids` string[]
- `custom_field_option_id` integer
- `deactivated` boolean
- `primary_email` string
- `external_office_id` string
- `external_department_id` string
- `show_service_accounts` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `primary_email` string — Primary email address on the user's account. Sign-in identifier and the address Greenhouse uses for outbound mail; additional verified addresses are not surfaced here. Service accounts (integration/ISU users) have no email and are excluded from this endpoint by default; when included via `show_service_accounts=true`, their `primary_email` is an empty string.
  - `job_title` string, nullable — Free-form job title set on the user's Greenhouse profile (e.g. `Senior Recruiter`). Not synchronized with any HRIS title.
  - `agency_id` integer, nullable — Id of the staffing agency this user belongs to, when the user is an external agency recruiter rather than an employee of your organization. `null` for in-house users.
  - `name` string, nullable — Concatenation of `first_name` and `last_name` rendered as a single display string. Provided for convenience; partners that need either component should read `first_name`/`last_name` directly.
  - `deactivated` boolean — Whether the user has been deactivated. Deactivated users cannot sign in or be assigned to new jobs, but their historical activity (notes, scorecards, emails) is preserved. Toggle via `POST /v3/users/{id}/deactivate` and `POST /v3/users/{id}/activate`.
  - `site_admin` boolean — Whether the user holds the Site Admin role. Site admins have unrestricted access to every non-confidential job and to organization-level settings. Demote a site admin to a Basic user with `POST /v3/users/{id}/revoke_permissions`.
  - `employee_id` string, nullable — Partner-supplied external employee identifier, typically the user's HRIS or payroll id. Free-form string; not unique across organizations and `null` when no employee id has been set.
  - `linked_candidate_ids` integer[] — Ids of candidate records linked to this user. Populated when an employee is represented by both a user record (for Greenhouse access) and a candidate record (for past or internal applications).
  - `office_ids` integer[] — Ids of the offices this user is assigned to. Used to scope future job permissions and to filter the user list by office. Empty when the user is not pinned to any office.
  - `department_ids` integer[] — Ids of the departments this user is assigned to. Used to scope future job permissions and to filter the user list by department. Empty when the user is not pinned to any department.
  - `interviewer_tags` object[] — Interviewer tags applied to this user — the labeled skill or panel groupings (e.g. `Senior Engineer`, `Bar Raiser`) used to suggest qualified interviewers when building an interview plan. Each entry pairs the tag's `id` with its `name`.
    - `id` integer, required
    - `name` string, required
  - `emails` string[] — All email addresses on the user's account, including the primary address and any additional verified addresses.
  - `custom_fields` object, nullable

---

[API](https://skmtc.net/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.net/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greenhouse/auth-api/versions/9517a2e54640/schema)