Greenhouse Jobs API
The Jobs API from Greenhouse — 3 operation(s) for jobs.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/greenhouse:greenhouse-jobs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Greenhouse Jobs API
version: '1.0'
description: 'Operations tagged Jobs across 4 of this provider''s published API definitions: greenhouse-harvest-openapi.yml, greenhouse-ingestion-openapi.yml, greenhouse-job-board-openapi.yml, greenhouse-jobs-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://harvest.greenhouse.io/v1
description: Production
- url: https://api.greenhouse.io/v1/partner
description: Production
- url: https://boards-api.greenhouse.io/v1/boards/{board_token}
description: Production
variables:
board_token:
default: example
description: The board token issued by Greenhouse for the organization.
tags:
- name: Jobs
paths:
/jobs:
get:
tags:
- Jobs
summary: List jobs
parameters:
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/PerPage'
responses:
'200':
description: A list of jobs
security:
- basicAuth: []
operationId: getJobs
x-operation-id-source: derived
servers:
- url: https://api.greenhouse.io/v1/partner
description: Production Partner API
post:
tags:
- Jobs
summary: Create Job
operationId: createJob
parameters:
- $ref: '#/components/parameters/OnBehalfOf_2'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/JobCreate'
responses:
'201':
description: Created.
content:
application/json:
schema:
$ref: '#/components/schemas/Job'
4XX:
$ref: '#/components/responses/ErrorResponse'
security:
- OAuth2:
- partner
- BasicAuth: []
/jobs/{id}:
parameters:
- $ref: '#/components/parameters/Id'
get:
tags:
- Jobs
summary: Retrieve job
responses:
'200':
description: A job
security:
- basicAuth: []
operationId: getJobsById
x-operation-id-source: derived
patch:
tags:
- Jobs
summary: Update job
responses:
'200':
description: Job updated
security:
- basicAuth: []
operationId: patchJobsById
x-operation-id-source: derived
servers:
- url: https://harvest.greenhouse.io/v1
description: Production
/jobs/{job_id}:
parameters:
- in: path
name: job_id
required: true
schema:
type: integer
get:
tags:
- Jobs
summary: Retrieve job
responses:
'200':
description: A job with application questions
operationId: getJobsByJobId
x-operation-id-source: derived
post:
tags:
- Jobs
summary: Submit application
description: Submit a job application using multipart form-data or JSON.
security:
- basicAuth: []
requestBody:
content:
multipart/form-data:
schema:
type: object
application/json:
schema:
type: object
responses:
'200':
description: Application submitted
operationId: postJobsByJobId
x-operation-id-source: derived
servers:
- url: https://boards-api.greenhouse.io/v1/boards/{board_token}
description: Production
variables:
board_token:
default: example
description: The board token issued by Greenhouse for the organization.
/jobs/{id}/hiring_team:
parameters:
- $ref: '#/components/parameters/Id'
servers:
- url: https://harvest.greenhouse.io/v1
description: Production Harvest API
get:
tags:
- Jobs
summary: Retrieve Job Hiring Team
operationId: getJobHiringTeam
responses:
'200':
description: Hiring team.
content:
application/json:
schema:
$ref: '#/components/schemas/HiringTeam'
4XX:
$ref: '#/components/responses/ErrorResponse'
security:
- BasicAuth: []
put:
tags:
- Jobs
summary: Replace Job Hiring Team
operationId: replaceJobHiringTeam
parameters:
- $ref: '#/components/parameters/OnBehalfOf_2'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HiringTeam'
responses:
'200':
description: Replaced.
content:
application/json:
schema:
$ref: '#/components/schemas/HiringTeam'
4XX:
$ref: '#/components/responses/ErrorResponse'
security:
- BasicAuth: []
/jobs/{id}/hiring_team_members:
servers:
- url: https://harvest.greenhouse.io/v1
description: Production Harvest API
post:
tags:
- Jobs
summary: Add Hiring Team Member
operationId: addHiringTeamMember
parameters:
- $ref: '#/components/parameters/Id'
- $ref: '#/components/parameters/OnBehalfOf_2'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- user_id
- role
properties:
user_id:
type: integer
role:
type: string
enum:
- hiring_manager
- recruiter
- coordinator
- sourcer
- interviewer
responses:
'201':
description: Added.
4XX:
$ref: '#/components/responses/ErrorResponse'
security:
- BasicAuth: []
/jobs/{id}/hiring_team_members/{user_id}:
servers:
- url: https://harvest.greenhouse.io/v1
description: Production Harvest API
delete:
tags:
- Jobs
summary: Remove Hiring Team Member
operationId: removeHiringTeamMember
parameters:
- $ref: '#/components/parameters/Id'
- name: user_id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/OnBehalfOf_2'
responses:
'204':
description: Removed.
4XX:
$ref: '#/components/responses/ErrorResponse'
security:
- BasicAuth: []
components:
parameters:
PerPage:
in: query
name: per_page
schema:
type: integer
default: 100
Id:
in: path
name: id
required: true
schema:
type: integer
Page:
in: query
name: page
schema:
type: integer
default: 1
OnBehalfOf_2:
name: On-Behalf-Of
in: header
required: false
description: The ID of the Greenhouse user the request is being made on behalf of.
schema:
type: integer
schemas:
HiringTeam:
type: object
properties:
hiring_managers:
type: array
items:
$ref: '#/components/schemas/UserRef'
recruiters:
type: array
items:
$ref: '#/components/schemas/UserRef'
coordinators:
type: array
items:
$ref: '#/components/schemas/UserRef'
sourcers:
type: array
items:
$ref: '#/components/schemas/UserRef'
Opening:
type: object
properties:
id:
type: integer
opening_id:
type: string
status:
type: string
enum:
- open
- closed
opened_at:
type: string
format: date-time
closed_at:
type: string
format: date-time
nullable: true
application_id:
type: integer
nullable: true
close_reason:
type: object
nullable: true
properties:
id:
type: integer
name:
type: string
custom_fields:
type: object
additionalProperties: true
Error:
type: object
properties:
message:
type: string
errors:
type: array
items:
type: object
properties:
field:
type: string
message:
type: string
UserRef:
type: object
nullable: true
properties:
id:
type: integer
first_name:
type: string
last_name:
type: string
name:
type: string
employee_id:
type: string
nullable: true
Office:
type: object
properties:
id:
type: integer
name:
type: string
location:
type: object
properties:
name:
type: string
parent_id:
type: integer
nullable: true
child_ids:
type: array
items:
type: integer
external_id:
type: string
nullable: true
Job:
type: object
properties:
id:
type: integer
name:
type: string
requisition_id:
type: string
nullable: true
notes:
type: string
confidential:
type: boolean
status:
type: string
enum:
- open
- closed
- draft
created_at:
type: string
format: date-time
opened_at:
type: string
format: date-time
nullable: true
closed_at:
type: string
format: date-time
nullable: true
updated_at:
type: string
format: date-time
departments:
type: array
items:
$ref: '#/components/schemas/Department'
offices:
type: array
items:
$ref: '#/components/schemas/Office'
hiring_team:
$ref: '#/components/schemas/HiringTeam'
custom_fields:
type: object
additionalProperties: true
openings:
type: array
items:
$ref: '#/components/schemas/Opening'
JobCreate:
type: object
required:
- name
- template_job_id
properties:
name:
type: string
template_job_id:
type: integer
requisition_id:
type: string
department_id:
type: integer
office_ids:
type: array
items:
type: integer
number_of_openings:
type: integer
Department:
type: object
properties:
id:
type: integer
name:
type: string
parent_id:
type: integer
nullable: true
parent_department_external_id:
type: string
nullable: true
child_ids:
type: array
items:
type: integer
external_id:
type: string
nullable: true
responses:
ErrorResponse:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
basicAuth:
type: http
scheme: basic
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://api.greenhouse.io/oauth/authorize
tokenUrl: https://api.greenhouse.io/oauth/token
scopes: {}
OAuth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.greenhouse.io/oauth/authorize
tokenUrl: https://app.greenhouse.io/oauth/token
scopes:
partner: Partner integration scope.
clientCredentials:
tokenUrl: https://app.greenhouse.io/oauth/token
scopes:
partner: Partner integration scope.
BasicAuth:
type: http
scheme: basic
description: HTTP Basic with the Partner API key as the username and an empty password.
x-refined-from:
- greenhouse-harvest-openapi.yml
- greenhouse-ingestion-openapi.yml
- greenhouse-job-board-openapi.yml
- greenhouse-jobs-api-openapi.yml