List user emails

User emails are the email addresses attached to a Greenhouse user. A user can hold multiple addresses — typically one work email plus aliases or historical addresses — but only one is the primary, which Greenhouse uses for sign-in and notifications and is exposed as primary_email on the /v3/users resource. Use this endpoint to resolve a list of addresses back to users (e.g. matching candidate-attributed emails to interviewer calendars), or to audit which secondary aliases are verified. The primary email itself cannot be switched through Harvest; use POST /v3/user_emails to add secondaries.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

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

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
user_ids
array of integers
length ≤ 50

Comma separated list

user_ids
fields
array of strings
length ≤ 50

Comma separated list of fields to return

fields
Allowed:
email
array of strings
length ≤ 50

Return only user emails matching one of these addresses. Comma separated, case-insensitive exact match; useful for resolving a list of candidate-attributed emails back to Greenhouse users.

email
boolean

Return only verified (true) or unverified (false) user emails. Omit to include both.

verification_token_sent_at
object

Filter by when the verification email was last sent. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. verification_token_sent_at[gte]=2026-01-01T00:00:00Z). Only matches rows that have an outstanding verification.

Response

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json