# Job Boards Greenhouse — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access job listings, department information, office locations, and application forms from Greenhouse.io job boards, then submit applications directly through the platform. Search and filter available positions by keywords to find roles that match your qualifications.

**Category:** Jobs | **Website:** [job-boards.greenhouse.io/](https://job-boards.greenhouse.io/) | **Docs:** [parse.bot/marketplace/064e5b88-4142-4fec-9a36-42424988bc55/job-boards-greenhouse-io-api](https://parse.bot/marketplace/064e5b88-4142-4fec-9a36-42424988bc55/job-boards-greenhouse-io-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get board info

Retrieve basic info about a company's Greenhouse job board, including the company name and any board-level content. One round-trip per board.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token (e.g. 'anthropic', 'spacex', 'stripe'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/get-board-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### Get job

Retrieve full details for a specific job, including HTML description content, compliance data, and application form questions. Requires both board_token and job_id. Returns upstream_error if the job does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `job_id` | string | Yes | The numeric job post ID. |
| `questions` | boolean | No | Whether to include application form questions in the response. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/get-job \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","job_id":"<string>","questions":"<boolean>"}'
```

### List departments

List all departments and their associated jobs for a company's Greenhouse board. Each department includes its id, name, parent_id, child_ids, and a jobs array. One round-trip.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/list-departments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### List jobs

Retrieve all job listings from a company's Greenhouse job board. Paginates server-side internally and returns the complete list. Each job includes id, title, absolute_url, location, departments, offices, and optionally content (HTML description). Large boards (300+ jobs) may take a few seconds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `content` | boolean | No | Whether to include full job description HTML and metadata. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/list-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","content":"<boolean>"}'
```

### List offices

List all offices/locations and their associated departments and jobs for a company's Greenhouse board. Each office includes id, name, location, parent_id, child_ids, and a departments array containing jobs. One round-trip.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/list-offices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>"}'
```

### Search jobs

Search for jobs using keyword, department, or office filters. Fetches all jobs from the board and filters client-side. query matches against title and HTML description. department and office use exact case-insensitive name matching. is_new restricts to jobs published within the last 7 days based on first_published timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_token` | string | Yes | The company's Greenhouse board token. |
| `department` | string | No | Department name to filter by (exact match, case-insensitive). |
| `is_new` | boolean | No | When true, only return jobs published within the last 7 days. |
| `office` | string | No | Office/location name to filter by (exact match, case-insensitive). |
| `query` | string | No | Keyword to search in job title and description. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-boards-greenhouse/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_token":"<string>","department":"<string>","is_new":"<boolean>","office":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.