Ashby Board Jobs API Documentation List the open jobs of one public Ashby job board. Each job has the id, title, location, secondary locations, remote flag, workplace type, department, team, employment type, salary, posted date, apply link and the full description in HTML and plain text. Compensation tiers (salary, bonus, equity) sit in extras.compensation. Filter by keyword (title, department, team), location (including secondary locations), department, team, workplace type and employment type. Filters run before paging, so every returned job matches and total_results is exact. Set include_compensation=false to drop all pay data from the answer. 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.
9 optional filters available.
string
Required
Ashby job board name, e.g. ashby (from jobs.ashbyhq.com/ashby).
example
string
Optional
Keyword in the title, department or team.
coffee shops
string
Optional
Text that must appear in the location or a secondary location.
Austin, Texas
string
Optional
Department name, matched without case.
example
string
Optional
Team name, matched without case.
example
string
Optional
remote, hybrid or onsite.
example
string
Optional
full_time, part_time, contract, intern or temporary.
example
boolean
Optional
Return salary and compensation tiers. Default: true.
true
integer
Optional
Page number, 1 to 1000. Default: 1.
1
integer
Optional
Jobs per page, 1 to 100. Default: 20.
10
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": "ashby:7458d4e9-da2e-47bd-98cb-adfda43d42b2",
"team": "EMEA Engineering",
"title": "Engineering Manager - EU",
"remote": true,
"salary": {
"max": 250000,
"min": 150000,
"currency": "EUR",
"interval": "yearly"
},
"department": "Engineering",
"workplace_type": "Remote",
"employment_type": "full_time"
}
],
"board": "ashby",
"pagination": {
"page": 1,
"limit": 20,
"has_more": true,
"next_page": 2,
"total_results": 40
}
},
"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": [
"An Ashby job board name is required, e.g. ashby (from jobs.ashbyhq.com/ashby)."
]
},
"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 Ashby job 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.