# Greenhouse JobPosts API

**Canonical:** https://apis.io/apis/greenhouse/greenhouse-io-jobposts-api/  
**Provider:** Greenhouse — https://apis.io/providers/greenhouse/  
**Base URL:** https://harvest.greenhouse.io/v1  
**Documentation:** https://developers.greenhouse.io/harvest.html

Greenhouse JobPosts API is one of 40 APIs that [Greenhouse](https://apis.io/providers/greenhouse/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Job Posts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, authentication docs, rate-limit docs, and 2 JSON Schemas.

Public-facing job postings and their statuses.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/job_posts` | List Job Posts |
| GET | `/job_posts/{id}` | Retrieve Job Post |
| PATCH | `/job_posts/{id}` | Update Job Post |
| GET | `/job_posts/{id}/custom_locations` | List Job Post Custom Locations |
| PATCH | `/job_posts/{id}/status` | Update Job Post Status |
| GET | `/jobs/{job_id}/job_posts` | List Job Posts For Job |
| GET | `/jobs/{job_id}/job_posts/{id}` | Retrieve Job Job Post |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/openapi/greenhouse-io-jobposts-api-openapi.yml
- **Documentation** — https://developers.greenhouse.io/harvest.html
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/json-schema/greenhouse-candidate-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/json-schema/greenhouse-job-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/json-ld/greenhouse-io-context.jsonld
- **Authentication** — https://developers.greenhouse.io/harvest.html#authentication
- **Pagination** — https://developers.greenhouse.io/harvest.html#pagination
- **RateLimits** — https://developers.greenhouse.io/harvest.html#rate-limits
- **Documentation** — https://developers.greenhouse.io/job-board.html
- **Authentication** — https://developers.greenhouse.io/job-board.html
- **Documentation** — https://developers.greenhouse.io/audit-log.html
- **Authentication**
- **RateLimits** — https://developers.greenhouse.io/audit-log.html
- **Retention**
- **Documentation** — https://developers.greenhouse.io/candidate-ingestion.html
- **Authentication** — https://developers.greenhouse.io/candidate-ingestion.html
- **Documentation** — https://developers.greenhouse.io/gho.html
- **RateLimits** — https://developers.greenhouse.io/gho.html
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/graphql/greenhouse-io-graphql.md
- **Documentation** — https://developers.greenhouse.io/assessment.html

## Other Greenhouse APIs (12)

- [Greenhouse Assessment API](https://apis.io/apis/greenhouse/assessment/)
- [Greenhouse Audit Log API](https://apis.io/apis/greenhouse/audit-log/)
- [Greenhouse Recruiting Webhooks](https://apis.io/apis/greenhouse/recruiting-webhooks/)
- [Greenhouse Onboarding Webhooks](https://apis.io/apis/greenhouse/onboarding-webhooks/)
- [Greenhouse Applications API](https://apis.io/apis/greenhouse/greenhouse-applications-api/)
- [Greenhouse Candidates API](https://apis.io/apis/greenhouse/greenhouse-candidates-api/)
- [Greenhouse Departments API](https://apis.io/apis/greenhouse/greenhouse-departments-api/)
- [Greenhouse Education API](https://apis.io/apis/greenhouse/greenhouse-education-api/)
- [Greenhouse Job Board API](https://apis.io/apis/greenhouse/greenhouse-greenhouse-job-board-api-api/)
- [Greenhouse Jobs API](https://apis.io/apis/greenhouse/greenhouse-jobs-api/)
- [Greenhouse Offices API](https://apis.io/apis/greenhouse/greenhouse-offices-api/)
- [Greenhouse Prospects API](https://apis.io/apis/greenhouse/greenhouse-prospects-api/)

## Tags

Job Posts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/greenhouse/greenhouse-io-jobposts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/greenhouse/.