Greenhouse

Greenhouse Applications API

Candidate applications to specific jobs, including stage advancement, transfers, hires, rejections, and attachments.

GitHub OpenAPI

Operations 15

GET /applications List Applications #
GET /applications/{id} Retrieve Application #
PATCH /applications/{id} Update Application #
DELETE /applications/{id} Delete Application #
POST /candidates/{id}/applications Add Application to Candidate #
POST /applications/{id}/advance Advance Application #
POST /applications/{id}/move Move Application #
POST /applications/{id}/transfer_to_job Transfer Application To Job #
PATCH /applications/{id}/convert_prospect Convert Prospect To Candidate #
POST /applications/{id}/attachments Add Application Attachment #
POST /applications/{id}/hire Hire Application #
POST /applications/{id}/reject Reject Application #
PATCH /applications/{id}/reject Update Rejection #
POST /applications/{id}/unreject Unreject Application #
POST /jobs/{id} Submit Application #

Documentation

📖
Documentation
https://developers.greenhouse.io/harvest.html
📖
Authentication
https://developers.greenhouse.io/harvest.html#authentication
📖
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
📖
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
📖
Documentation
https://developers.greenhouse.io/assessment.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/greenhouse-io/refs/heads/main/openapi/greenhouse-io-applications-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/greenhouse-io/refs/heads/main/json-schema/greenhouse-candidate-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/greenhouse-io/refs/heads/main/json-schema/greenhouse-job-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/greenhouse-io/refs/heads/main/json-ld/greenhouse-io-context.jsonld
🔗
Pagination
https://developers.greenhouse.io/harvest.html#pagination
🔗
Retention
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/greenhouse-io/refs/heads/main/graphql/greenhouse-io-graphql.md

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/greenhouse-io-applications-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

greenhouse-io-applications-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Greenhouse Io Applications API
  version: 1.0.0
  contact:
    name: Greenhouse Software
    url: https://www.greenhouse.com
    email: developers@greenhouse.io
  description: 'Operations tagged Applications across 2 of this provider''s published API definitions: greenhouse-harvest-api-openapi.yml, greenhouse-job-board-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://harvest.greenhouse.io/v1
  description: Production Harvest API
- url: https://boards-api.greenhouse.io/v1/boards/{board_token}
  description: Public Job Board API
  variables:
    board_token:
      default: example
      description: The customer's unique board token (e.g. "exampleco").
tags:
- name: Applications
  description: Candidate applications to specific jobs, including stage advancement, transfers, hires, rejections, and attachments.
paths:
  /applications:
    get:
      tags:
      - Applications
      summary: List Applications
      description: Returns a paginated list of all applications across the organization.
      operationId: listApplications
      parameters:
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/CreatedAfter'
      - $ref: '#/components/parameters/CreatedBefore'
      - $ref: '#/components/parameters/UpdatedAfter'
      - $ref: '#/components/parameters/UpdatedBefore'
      - name: job_id
        in: query
        schema:
          type: integer
      - name: status
        in: query
        schema:
          type: string
          enum:
          - active
          - rejected
          - hired
          - converted
      - $ref: '#/components/parameters/OnBehalfOf'
      responses:
        '200':
          description: Array of applications.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Application'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}:
    parameters:
    - $ref: '#/components/parameters/Id'
    get:
      tags:
      - Applications
      summary: Retrieve Application
      operationId: getApplication
      responses:
        '200':
          description: A single application.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Application'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    patch:
      tags:
      - Applications
      summary: Update Application
      operationId: updateApplication
      parameters:
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationUpdate'
      responses:
        '200':
          description: Updated application.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Application'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    delete:
      tags:
      - Applications
      summary: Delete Application
      operationId: deleteApplication
      parameters:
      - $ref: '#/components/parameters/OnBehalfOf'
      responses:
        '204':
          description: Deleted.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /candidates/{id}/applications:
    post:
      tags:
      - Applications
      summary: Add Application to Candidate
      operationId: addCandidateApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationCreate'
      responses:
        '201':
          description: Created application.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Application'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/advance:
    post:
      tags:
      - Applications
      summary: Advance Application
      description: Move the application to the next interview stage.
      operationId: advanceApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      responses:
        '200':
          description: Advanced.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/move:
    post:
      tags:
      - Applications
      summary: Move Application
      description: Move the application to a specific stage.
      operationId: moveApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - from_stage_id
              - to_stage_id
              properties:
                from_stage_id:
                  type: integer
                to_stage_id:
                  type: integer
      responses:
        '200':
          description: Moved.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/transfer_to_job:
    post:
      tags:
      - Applications
      summary: Transfer Application To Job
      operationId: transferApplicationToJob
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - new_job_id
              properties:
                new_job_id:
                  type: integer
                new_job_stage_id:
                  type: integer
      responses:
        '200':
          description: Transferred.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/convert_prospect:
    patch:
      tags:
      - Applications
      summary: Convert Prospect To Candidate
      operationId: convertProspect
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                job_id:
                  type: integer
                job_stage_id:
                  type: integer
      responses:
        '200':
          description: Converted.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/attachments:
    post:
      tags:
      - Applications
      summary: Add Application Attachment
      operationId: addApplicationAttachment
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Attachment'
      responses:
        '201':
          description: Attached.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/hire:
    post:
      tags:
      - Applications
      summary: Hire Application
      operationId: hireApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                start_date:
                  type: string
                  format: date
                opening_id:
                  type: integer
      responses:
        '200':
          description: Hired.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/reject:
    post:
      tags:
      - Applications
      summary: Reject Application
      operationId: rejectApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rejection_reason_id:
                  type: integer
                notes:
                  type: string
      responses:
        '200':
          description: Rejected.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    patch:
      tags:
      - Applications
      summary: Update Rejection
      operationId: updateApplicationRejection
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rejection_reason_id:
                  type: integer
                notes:
                  type: string
      responses:
        '200':
          description: Updated rejection.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /applications/{id}/unreject:
    post:
      tags:
      - Applications
      summary: Unreject Application
      operationId: unrejectApplication
      parameters:
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/OnBehalfOf'
      responses:
        '200':
          description: Unrejected.
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BasicAuth: []
    servers:
    - url: https://harvest.greenhouse.io/v1
      description: Production Harvest API
  /jobs/{id}:
    post:
      tags:
      - Applications
      summary: Submit Application
      description: Submit a candidate application to a job posting. Accepts multipart/form-data or JSON. Requires Basic auth.
      operationId: submitApplication
      security:
      - BasicAuth: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationSubmission'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ApplicationSubmission'
      responses:
        '200':
          description: Application accepted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: string
    servers:
    - url: https://boards-api.greenhouse.io/v1/boards/{board_token}
      description: Public Job Board API
      variables:
        board_token:
          default: example
          description: The customer's unique board token (e.g. "exampleco").
components:
  schemas:
    ApplicationCreate:
      type: object
      required:
      - job_id
      properties:
        job_id:
          type: integer
        source_id:
          type: integer
        initial_stage_id:
          type: integer
        referrer:
          type: object
          properties:
            type:
              type: string
              enum:
              - outside
              - id
              - email
            value:
              type: string
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/Attachment'
    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
    Error:
      type: object
      properties:
        message:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
    ApplicationUpdate:
      type: object
      properties:
        source_id:
          type: integer
        prospect_owner_id:
          type: integer
        prospect_pool_id:
          type: integer
        prospect_stage_id:
          type: integer
        custom_fields:
          type: object
          additionalProperties: true
    Application:
      type: object
      properties:
        id:
          type: integer
        candidate_id:
          type: integer
        prospect:
          type: boolean
        applied_at:
          type: string
          format: date-time
        rejected_at:
          type: string
          format: date-time
          nullable: true
        last_activity_at:
          type: string
          format: date-time
        location:
          type: object
          properties:
            address:
              type: string
        source:
          type: object
          properties:
            id:
              type: integer
            public_name:
              type: string
        credited_to:
          $ref: '#/components/schemas/UserRef'
        rejection_reason:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            name:
              type: string
        rejection_details:
          type: object
          nullable: true
        jobs:
          type: array
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
        job_post_id:
          type: integer
          nullable: true
        status:
          type: string
          enum:
          - active
          - rejected
          - hired
          - converted
        current_stage:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
        answers:
          type: array
          items:
            type: object
            properties:
              question:
                type: string
              answer:
                type: string
        custom_fields:
          type: object
          additionalProperties: true
    Attachment:
      type: object
      required:
      - filename
      - type
      properties:
        filename:
          type: string
        url:
          type: string
          format: uri
        type:
          type: string
          enum:
          - resume
          - cover_letter
          - admin_only
          - public
          - offer_letter
          - take_home_test
          - offer_packet
        content:
          type: string
          description: Base64 file content.
        content_type:
          type: string
    ApplicationSubmission:
      type: object
      required:
      - first_name
      - last_name
      - email
      properties:
        first_name:
          type: string
        last_name:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        location:
          type: string
          description: City, State / Country.
        resume_text:
          type: string
        resume_text_file:
          type: string
          description: Base64-encoded resume file content.
        resume_content_filename:
          type: string
        resume_content_type:
          type: string
        cover_letter_text:
          type: string
        cover_letter_content:
          type: string
          description: Base64-encoded cover letter.
        cover_letter_content_filename:
          type: string
        question_id:
          type: string
          description: Greenhouse-defined custom question identifiers; multiple entries allowed.
  responses:
    ErrorResponse:
      description: Error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    CreatedAfter:
      name: created_after
      in: query
      schema:
        type: string
        format: date-time
    UpdatedAfter:
      name: updated_after
      in: query
      schema:
        type: string
        format: date-time
    Page:
      name: page
      in: query
      schema:
        type: integer
        default: 1
    PerPage:
      name: per_page
      in: query
      description: Default 100, max 500.
      schema:
        type: integer
        default: 100
        maximum: 500
    CreatedBefore:
      name: created_before
      in: query
      schema:
        type: string
        format: date-time
    OnBehalfOf:
      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
    UpdatedBefore:
      name: updated_before
      in: query
      schema:
        type: string
        format: date-time
    Id:
      name: id
      in: path
      required: true
      schema:
        type: integer
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: HTTP Basic with the Harvest API key as the username and an empty password (Base64 encoded).
x-refined-from:
- greenhouse-harvest-api-openapi.yml
- greenhouse-job-board-api-openapi.yml