# Ashby Board Jobs API Documentation

<p><strong>Ashby Board Jobs API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/ashby-api/ashby_jobs](https://scrappa.co/docs/ashby-api/ashby_jobs)
- **API group:** Ashby Jobs API
- **Endpoint:** `GET https://scrappa.co/api/ashby/jobs`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `board` | string | Yes | Ashby job board name, e.g. ashby (from jobs.ashbyhq.com/ashby). |
| `q` | string | No | Keyword in the title, department or team. |
| `location` | string | No | Text that must appear in the location or a secondary location. |
| `department` | string | No | Department name, matched without case. |
| `team` | string | No | Team name, matched without case. |
| `workplace_type` | string | No | remote, hybrid or onsite. |
| `employment_type` | string | No | full_time, part_time, contract, intern or temporary. |
| `include_compensation` | boolean | No | Return salary and compensation tiers. Default: true. |
| `page` | integer | No | Page number, 1 to 1000. Default: 1. |
| `limit` | integer | No | Jobs per page, 1 to 100. Default: 20. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The board, company or job does not exist. This response is not billable. |
| 503 | Upstream Error | The job board did not answer. Try again shortly. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)