Greenhouse Harvest API

Name: Greenhouse Harvest API
Brand: Greenhouse Harvest API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHR recruitingRecruiting Atsbasic11 EndpointsREST

For Agents

Read Greenhouse candidates, applications, jobs, departments, offices, users, and scheduled interviews for ATS automation.

Install Jentic One Beta

Connect the Greenhouse Harvest API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Greenhouse Harvest API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Greenhouse Harvest API.

List and retrieve candidates from /candidates and /candidates/{id}

Read applications associated with candidates and jobs via /applications

Inspect open and archived jobs via /jobs

GET STARTED

Start building with Greenhouse Harvest API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Greenhouse Harvest API for, with concrete tasks.

★ ATS Data Sync into a Data Warehouse

People analytics teams pull Harvest data on a schedule into a data warehouse to build hiring funnel dashboards, time-to-hire reports, and diversity analyses. The /candidates, /applications, and /jobs endpoints together provide the canonical data set for funnel reporting.

Iterate /candidates with pagination over the last 30 days and load the records into a warehouse table

Interview Scheduling Notifications

Recruiting coordinators run automation that polls /scheduled_interviews to detect newly booked interviews and post reminders into a chat tool with the candidate name, role, and panel. The endpoint returns interview times and panellist information needed to compose the message.

GET /scheduled_interviews for the next 24 hours and post each one to the recruiting chat channel

Job and Department Reference Data Refresh

HRIS integrations refresh local mirrors of Greenhouse jobs, departments, and offices on a daily cadence so that downstream tools stay accurate. Each endpoint accepts pagination so that large catalogues can be retrieved in batches.

Page through /jobs, /departments, and /offices and replace the local reference tables with the latest Greenhouse data

Agent-Driven Recruiting Assistant via Jentic

An AI recruiting assistant uses Jentic to discover the right Harvest endpoint when a recruiter asks 'who applied to the senior backend role?' or 'what interviews are tomorrow?'. Jentic injects the basic auth credentials from the vault and the agent works against structured Greenhouse data.

Search Jentic for 'list greenhouse candidates by job', load the schema, and execute /candidates filtered by job_id

Key Endpoints

11 endpoints — jentic publishes the only available openapi specification for greenhouse harvest api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/candidates

List candidates

GET

/candidates/{id}

Retrieve a candidate by id

GET

/applications

List applications

GET

/jobs

List jobs

GET

/users

List recruiter users

GET

/scheduled_interviews

List scheduled interviews

GET

/departments

List departments

GET

/offices

List offices

GET

/candidates

List candidates

GET

/candidates/{id}

Retrieve a candidate by id

GET

/applications

List applications

GET

/jobs

List jobs

GET

/users

List recruiter users

GET

/scheduled_interviews

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Greenhouse Harvest API keys are stored encrypted in the Jentic vault. Jentic builds the basic auth header (key as username, empty password) at execution time so the raw key never enters the agent's context.

Intent-based discovery

Agents search Jentic by intent (e.g., 'list greenhouse candidates by job') and Jentic returns the matching Harvest operation with its query schema, so the agent can target /candidates or /applications directly.

Time to first call

Direct Greenhouse Harvest integration: half a day to wire basic auth, pagination, and 429 backoff. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Greenhouse Harvest API through Jentic.

Why is there no official OpenAPI spec for Greenhouse Harvest API?

Greenhouse documents the Harvest API in their developer portal but does not publish a maintained OpenAPI 3 file for tooling. Jentic generates and maintains this spec so that AI agents and developers can call Greenhouse Harvest API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Greenhouse Harvest API use?

The Harvest API uses HTTP basic authentication. The username portion is the Harvest API key issued from the Greenhouse account settings, and the password portion is left empty. Through Jentic the API key is held in the encrypted vault and the basic auth header is built per call.

Can I list every application associated with a candidate?

Yes. GET /candidates/{id} returns the candidate including their applications, and GET /applications can be filtered by candidate_id or job_id to retrieve the application list directly. Pagination uses the standard Harvest per_page and page query parameters.

What are the rate limits for the Greenhouse Harvest API?

Greenhouse enforces a default Harvest rate limit of 50 requests per 10 seconds per API key, with burst behaviour. Exceeding the limit returns HTTP 429 with a Retry-After header. Jentic propagates the 429 so the agent can back off rather than hammer the limit.

How do I retrieve upcoming scheduled interviews through Jentic?

Search Jentic for 'list greenhouse scheduled interviews', load the operation that maps to GET /scheduled_interviews, and execute it with optional starts_after and ends_before filters. The response lists interview times and panellists which the agent can render into a chat reminder.

Does the API let me post a new candidate or schedule an interview?

The 11 endpoints in this spec are read-style operations. Greenhouse provides a separate Ingestion API for creating candidates from sourcing tools and the Harvest API itself supports additional write endpoints under specific permissions. Confirm with your Greenhouse account admin which scopes are enabled before relying on writes.