---
title: "List approvers"
method: GET
path: "/v3/approvers"
tags: ["Approvers"]
---

# List approvers

`GET /v3/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.

## 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
- `approver_group_ids` integer[]
- `user_ids` integer[]
- `fields` string[]
- `status` 'waiting' | 'due' | 'approved' | 'rejected'

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `sort_order` integer, nullable — Position of this approver within its approver group. Lower values are asked to approve first when the parent approval flow is sequential.
  - `user_id` integer — 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_id` integer, 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_at` string, date-time, nullable — ISO 8601 timestamp when this approver was resolved (approved or rejected). Null while the approver is `waiting` or `due`.
  - `request_sent_at` string, 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_sent` integer, 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_at` string, 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_id` integer, 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_sent` integer, nullable — Count of manual reminders sent to this approver. Distinct from `auto_reminders_sent`.
  - `approver_group_id` integer, 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_id` integer, 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_at` string, 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_sent` integer, nullable — Count of automatic reminders sent to this approver since the request was last issued. Resets when the parent approval flow is restarted.

---

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