List users

get

https://harvest.greenhouse.io/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_page

integer

1 to 500

Defaults to 100

Number of results per page

ids

array of integers

length ≤ 50

Comma separated list

ids

created_at

object

updated_at

object

agency_ids

array of integers

length ≤ 50

Return only users belonging to one of these recruiting Agency ids. Greenhouse stores agencies as separate records from users — fetch ids via GET /v3/agencies. Users without an agency association will not match.

agency_ids

office_ids

array of integers

length ≤ 50

Comma separated list

office_ids

department_ids

array of integers

length ≤ 50

Comma separated list

department_ids

linked_candidate_ids

array of integers

length ≤ 50

Return only users who are linked to one of these candidate ids via a person link (used when a candidate also exists as a Greenhouse user, e.g. an ex-employee re-entering the funnel). Look up the candidate id via GET /v3/candidates.

linked_candidate_ids

interviewer_tag_ids

array of integers

length ≤ 50

Return only users who have one of these interviewer Tag ids assigned. Interviewer tags are used to group users into interview panels — resolve ids via the tags endpoint.

interviewer_tag_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

employee_ids

array of strings

length ≤ 50

Return only users whose employee_id is in this list. Useful for HRIS-driven sync where the partner only has external employee identifiers.

employee_ids

custom_field_option_id

integer

Return only users whose user-attribute custom field value selects this custom_field_option id.

deactivated

boolean

Filter by activation state. true returns only deactivated users; false returns only active users; omit to return both.

primary_email

string

Return only the user whose primary_email matches this address (exact match).

external_office_id

string

Return only users assigned to the office whose external_id matches this value. Use this when the partner only has external office identifiers; prefer office_id (via the parent filter) when the Greenhouse id is already known.

external_department_id

string

Return only users assigned to the department whose external_id matches this value. Use this when the partner only has external department identifiers; prefer department_id (via the parent filter) when the Greenhouse id is already known.

show_service_accounts

boolean

If true, include integration/service-account users (used by Harvest integrations and ISUs) in the result set. Defaults to false, which omits them.

Response

200Successful