# Greenhouse Job

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/greenhouse/job` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/greenhouse-job |

## Description

Fetch one Greenhouse job by board/id, such as discord/8806482002, or by a job-boards.greenhouse.io job URL.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/greenhouse/job' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Commercial Policy Lead

```json
{
  "id": 8806482002,
  "url": "https://job-boards.greenhouse.io/discord/jobs/8806482002",
  "title": "Commercial Policy Lead",
  "offices": [
    "Remote (US)"
  ],
  "language": "en",
  "location": "San Francisco Bay Area",
  "updated_at": "2026-10-20T20:27:20-04:00",
  "departments": [
    "Policy"
  ],
  "description": "Discord has a highly engaged community of millions of daily active users who use the platform for many different reasons, but there’s one thing that nearly everyone does: play video games. Discord plays a uniquely important role in the future of gaming, and we are focused on making it easier and more fun for people to hang out before, during, and after playing games. We are seeking a strategic Commercial Policy Lead to shape Discord's approach to monetization and revenue products. As a key member of the Product Policy organization, you will develop and implement advertising and commerce policies that enable Discord's business while maintaining platform safety and user trust. This role requires a deep understanding of digital commerce, creator economies, and advertising ecosystems, with the ability to balance business objectives with responsible platform practices.",
  "company_name": "Discord",
  "requisition_id": "R-107406",
  "first_published": "2026-09-15T12:52:11-04:00",
  "application_deadline": null
}
```

## Documentation

## Overview
Fetch one Greenhouse job. `query` is `{board}/{job id}`, for example `discord/8806482002`, or `https://job-boards.greenhouse.io/discord/jobs/8806482002`. The response is a flat object. `description` is plain text taken from the posting HTML. Search cards do not include `description`, `departments`, or `offices`.

## Quickstart
```
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/job?query=discord/8806482002"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/greenhouse/job?query=https%3A%2F%2Fjob-boards.greenhouse.io%2Fdiscord%2Fjobs%2F8806482002"
```

## Parameters
| Name | Detail |
|---|---|
| query | Required string. `{board}/{job id}` or a job URL. Example: `discord/8806482002`. |

## Response fields
| Name | Detail |
|---|---|
| id | Integer. Same id as the search card. |
| title | String. |
| description | String or null. Full plain-text posting. |
| departments | Array of strings. |
| offices | Array of strings. |
| company_name | String or null. |
| location | String or null. |
| url | String. Public job URL. |
| updated_at | String or null. |
| first_published | String or null. |
| requisition_id | String or null. |
| language | String or null. |
| application_deadline | String or null. |

## Pagination
One job. No `pagination` object.

## Use cases
- An ATS mirror fetches the plain-text description for `discord/8806482002` after a board search.
- A job alert stores `departments` and `offices` for one posting.
- A career page links the public `url` returned for that board and id.

## Error codes
| Name | Detail |
|---|---|
| 400 | Missing board or job id, a non-numeric id, or a host other than greenhouse.io. |
| 404 | Unknown job. |
| 401 | Missing API key. |
| 500 | The Greenhouse request failed. |

## Related endpoints
- [Greenhouse Search](https://www.piloterr.com/library/greenhouse-search)