List job posts

get

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

Job posts are the candidate-facing listings of a job. A single job can have multiple posts — typically one per locale, geography, or audience — each published to either an external job_board (a public careers site or syndicated board like LinkedIn) or the organization's internal job board. Posts carry their own public title, HTML description, application form questions, and live state independent of the parent job.

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 posts belonging to these job (hiring plan) ids. Each job post is published against a single job.

job_ids

job_board_ids

array of integers

length ≤ 50

Comma separated list

job_board_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

active

boolean

Filter by whether the post is active (not deleted). Defaults to true; pass false to retrieve soft-deleted posts.

featured

boolean

Filter by featured status on the organization's internal job board. Only internal posts can be featured.

live

boolean

When true, return only posts that are published and whose job board is also live — equivalent to posts whose public_url is reachable. When false, return posts that are not published or whose board is not live.

internal

boolean

Filter by post visibility. true returns posts on internal job boards (visible to employees); false returns external posts on public job boards. Omit to return both.

Response

Language

Credentials

Loading…

Response

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

application/json

200Successful