# Greenhouse Candidates API (Harvest full reference)

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

Greenhouse Candidates API (Harvest full reference) 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 Candidates. 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.

Create or retrieve candidates / prospects in the customer's Greenhouse account.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/candidates` | List Partner Candidates |
| POST | `/candidates` | Create Partner Candidate |
| DELETE | `/candidates` | Delete Candidates Bulk |
| GET | `/candidates/{id}` | Retrieve Candidate |
| PATCH | `/candidates/{id}` | Update Candidate |
| POST | `/candidates/{id}/attachments` | Add Candidate Attachment |
| POST | `/candidates/{id}/notes` | Add Candidate Note |
| POST | `/candidates/{id}/email_notes` | Add Candidate Email Note |
| POST | `/candidates/{id}/education` | Add Candidate Education |
| DELETE | `/candidates/{id}/education/{education_id}` | Delete Candidate Education |
| POST | `/candidates/{id}/employment` | Add Candidate Employment |
| DELETE | `/candidates/{id}/employment/{employment_id}` | Delete Candidate Employment |
| POST | `/candidates/{id}/prospect` | Convert Candidate To Prospect |
| PUT | `/candidates/{id}/anonymize` | Anonymize Candidate |
| PUT | `/candidates/{id}/merge` | Merge Candidate |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/greenhouse/refs/heads/main/openapi/greenhouse-io-candidates-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

Candidates

---

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