# Greenhouse Board Jobs API Documentation

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

- **Documentation:** [https://scrappa.co/docs/greenhouse-api/greenhouse_jobs](https://scrappa.co/docs/greenhouse-api/greenhouse_jobs)
- **API group:** Greenhouse Jobs API
- **Endpoint:** `GET https://scrappa.co/api/greenhouse/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 | Greenhouse board token, e.g. stripe (from boards.greenhouse.io/stripe). |
| `q` | string | No | Keyword that must appear in the job title. |
| `location` | string | No | Text that must appear in the job location, e.g. Dublin. |
| `page` | integer | No | Page number, 1 to 1000. Default: 1. |
| `limit` | integer | No | Jobs per page, 1 to 100. Default: 20. |
| `include_content` | boolean | No | Add the full description, departments and offices to every job. Default: false. |

## Example response

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

| 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)