Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Approvers

List approvers

Approvers are the individual users assigned to approve a job, offer, or other approvable resource. Each approver belongs to an approver group (/v3/approver_groups), and the group in turn belongs to an approval flow (/v3/approval_flows); the same user appears as multiple approvers when they are assigned across multiple flows. Filter by status to find pending (waiting, due) vs. resolved (approved, rejected) approvers, and by user_ids or approver_group_ids to scope to specific people or groups.

get/v3/approvers

Query parameters

cursorstring

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

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
approver_group_idsinteger[]

Comma separated list

user_idsinteger[]

Return only approver records assigned to these Greenhouse user ids (the users acting as approvers on the parent approver group).

fieldsstring[]

Comma separated list of fields to return

status'waiting' | 'due' | 'approved' | 'rejected'

Filter by the approver's current state. waiting and due return pending approvers (commonly used to find approvals still owed); approved and rejected return resolved approvers.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
sort_orderinteger nullable

Position of this approver within its approver group. Lower values are asked to approve first when the parent approval flow is sequential.

user_idinteger

Id of the user designated as an approver. References a /v3/users row.

status'waiting' | 'due' | 'approved' | 'rejected'

Current state of this approver's response. waiting means earlier approvers (or the parent flow) have not yet activated this approver, due means a request has been sent and is pending action, approved and rejected are the resolved outcomes.

resolved_by_idinteger nullable

Id of the user who approved or rejected on this approver's behalf. References a /v3/users row. Null until status is approved or rejected; usually equal to user_id unless an admin resolved the request for them.

resolved_atstring date-time nullable

ISO 8601 timestamp when this approver was resolved (approved or rejected). Null while the approver is waiting or due.

request_sent_atstring date-time nullable

ISO 8601 timestamp when the approval request email was first sent to this approver. Null until the parent approval flow reaches this approver.

version_sentinteger nullable

Version of the parent approval flow at the time the request was sent to this approver. If the flow is later edited and its version increments, this value lets you tell whether the approver is responding to the current version or a stale request.

reminder_sent_atstring date-time nullable

ISO 8601 timestamp of the most recent manual reminder sent to this approver. Null if no manual reminder has been sent.

reminder_sent_by_idinteger nullable

Id of the user who sent the most recent manual reminder. References a /v3/users row. Null if no manual reminder has been sent.

reminders_sentinteger nullable

Count of manual reminders sent to this approver. Distinct from auto_reminders_sent.

approver_group_idinteger nullable

Id of the approver group this approver belongs to. References a /v3/approver_groups row. The parent approval flow is reachable via the group.

added_by_custom_field_idinteger nullable

Id of the custom field that resolved to this approver, when the approver was added dynamically via a user-typed custom field (for example, a Hiring Manager field). Null when the approver was set explicitly rather than via a custom field.

send_auto_reminder_atstring nullable

Date (YYYY-MM-DD) when the next automatic reminder is scheduled to send. Null when no auto-reminder is queued — either because the approver is not due, automatic reminders are disabled for the organization, or the configured reminder limit has been reached.

auto_reminders_sentinteger nullable

Count of automatic reminders sent to this approver since the request was last issued. Resets when the parent approval flow is restarted.