Greenhouse Board Jobs API Documentation List the open jobs of one public Greenhouse board. Each job has the id, title, company, location, posted date, apply link, department, team, salary and extras such as requisition id, language and compliance data. Filter by title keyword (q) and location text. Filters run before paging, so every returned job matches and total_results is exact. Set include_content=true to get the full description of each job (description_html and description_text), and departments and offices. A page has up to 100 jobs. A board with no match returns an empty list. An unknown board returns 404. Cost: 1 credit per successful request. Failed requests and empty answers from a missing board cost nothing.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Greenhouse board token, e.g. stripe (from boards.greenhouse.io/stripe).
example
string
Optional
Keyword that must appear in the job title.
coffee shops
string
Optional
Text that must appear in the job location, e.g. Dublin.
Austin, Texas
integer
Optional
Page number, 1 to 1000. Default: 1.
1
integer
Optional
Jobs per page, 1 to 100. Default: 20.
10
boolean
Optional
Add the full description, departments and offices to every job. Default: false.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"jobs": [
{
"id": "greenhouse:8172487",
"title": "Abuse Investigator",
"remote": null,
"company": {
"name": "Stripe",
"slug": "stripe"
},
"location": {
"all": [
"Dublin"
],
"raw": "Dublin",
"country": null
},
"apply_url": "https://stripe.com/jobs/search?gh_jid=8172487",
"posted_at": "2026-09-03T13:30:34-04:00"
}
],
"board": "stripe",
"pagination": {
"page": 1,
"limit": 20,
"has_more": false,
"next_page": null,
"total_results": 12
}
},
"meta": {
"credits": 1,
"billable": true
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"param": [
"A Greenhouse board token is required, e.g. stripe (from boards.greenhouse.io/stripe)."
]
},
"message": "The request validation failed"
}Not Found
The board, company or job does not exist. This response is not billable.
{
"error": {
"code": "not_found",
"message": "No Greenhouse board found for 'unknown-board'."
},
"success": false
}Upstream Error
The job board did not answer. Try again shortly. This response is not billable.
{
"error": {
"code": "upstream_error",
"message": "The job board did not answer. Try again shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.