List approval flows

get

https://harvest.greenhouse.io/v3/approval_flows

Approval flows are the multi-step approval definitions attached to a job or to a candidate's offer. Each flow has an ordered list of approver groups (/v3/approver_groups?approval_flow_ids=), and each group holds the individual approvers (/v3/approvers?approver_group_ids=); a flow resolves as approved only when every group resolves as approved. Filter by approval_type to scope to job-opening, job-offer, or candidate-offer flows, and by job_ids or offer_ids to scope to specific parents. Default approval flows that serve as the prototype for new jobs are not returned here.

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

job_ids

array of integers

length ≤ 50

Return only approval flows that gate these job (hiring plan) ids. Matches open_job and offer_job flows whose hiring_plan_id is in the list; offer_candidate flows are excluded since they hang off an offer rather than a job.

job_ids

offer_ids

array of integers

length ≤ 50

Return only offer_candidate approval flows for these offer ids. Each offer has its own approver chain — distinct from the open_job/offer_job flows on the underlying job — so filter by offer_ids to fetch just the candidate-level offer approvals.

offer_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

approval_type

string

enum

Filter by the kind of approval the flow gates: open_job (opening the job), offer_job (allowing offers on the job), or offer_candidate (extending an individual offer).

Allowed:

Response

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful