---
title: "List approver groups"
method: GET
path: "/v3/approver_groups"
tags: ["Approver Groups"]
---

# List approver groups

`GET /v3/approver_groups`

Approver groups are the ordered tiers of approvers inside a single approval flow on a job or offer. Each group has its own `approvals_required` threshold (e.g., "any 1 of 3" or "all 4") and resolves as approved once that many of its members approve, or as rejected once enough members reject. Groups with a lower `sort_order` must resolve as approved before later groups become actionable. Filter to a specific flow with `approval_flow_ids` and look up the individual people in each group via `/v3/approvers?approver_group_ids=`. To restructure the tiers themselves, use `PUT /v3/approval_flows/{id}/replace_approver_groups`; to swap one person within a group, use `PUT /v3/approver_groups/{id}/replace_approver`.

## 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
- `approval_flow_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `approval_flow_id` integer — Id of the approval flow this group belongs to.
  - `approvals_required` integer — Number of approvers in this group whose `approve` actions are needed to resolve the group as approved (i.e., the M in "M of N"). Defaults to 1. The group resolves as rejected once enough approvers reject that the remaining members can no longer reach this threshold.
  - `sort_order` integer — Zero-based position of this group within its approval flow. Groups with the same `sort_order` resolve in parallel; groups with a higher `sort_order` only become actionable once all earlier groups have resolved as approved.
  - `required_for_exception` boolean — When `true`, this group must still approve even when the approval flow is being processed as an exception (where other groups can be skipped). Defaults to `false`.
  - `resolved_at` string, date-time, nullable — ISO 8601 timestamp at which the group reached a terminal state (all `approvals_required` approvals received, or enough rejections to make that impossible). Null while the group is still pending.

---

[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)