Lever

Lever is a talent acquisition and applicant tracking platform built on the Opportunities data model. The Lever API exposes candidates, opportunities, postings, interviews, feedback, requisitions, users, files, webhooks, and a public Postings API for embedding job sites.

23 APIs 9 Features

HRATSRecruitingTalent AcquisitionSaaS

APIs

Lever Opportunities API

Opportunities are Lever's primary candidate-centric resource. List, create, advance, archive, and update candidate opportunities through the hiring pipeline. Replaces the legacy...

Lever Candidates API

Legacy Candidates endpoints maintained for backward compatibility. New integrations should use Opportunities; Candidates remain available for historical record retrieval.

Lever Contacts API

Contacts represent unique people across multiple opportunities, allowing Lever to deduplicate candidates who apply to multiple roles.

Lever Postings API

Manage job postings programmatically and power custom public job sites. The Postings API has a public read-only mode that does not require authentication for displaying job list...

Lever Applications API

Submit candidate applications against postings, including resumes, cover letters, and EEO survey data, and retrieve historical application records.

Lever Stages API

List the configured pipeline stages and disposition stages used to route opportunities through screening, interviews, offer, and hire.

Lever Archive Reasons API

Read archive reasons used when an opportunity is archived (rejected, hired, withdrawn) for downstream EEO and analytics reporting.

Lever Interviews API

Read interview events, panels, and schedules associated with an opportunity, including interviewer assignments and time slots.

Lever Feedback API

Read feedback forms and scorecards completed by interviewers and hiring managers, with templated and free-form fields.

Lever Feedback Templates API

Manage feedback form templates, including question definitions and scoring rubrics applied across postings and stages.

Lever Notes API

Add and retrieve free-form notes attached to opportunities for recruiter and hiring manager collaboration.

Lever Offers API

Read offer records associated with opportunities, including offer letters, approval status, and compensation breakdowns.

Lever Requisitions API

Manage requisitions backing each posting — headcount, compensation bands, and approval state — typically synced from an HRIS.

Lever Tags API

List and apply tags to opportunities for cohorting, sourcing, and reporting workflows.

Lever Sources API

Read source attribution (job board, referral, sourced) for opportunities to drive sourcing analytics.

Lever Files API

Upload and download files (resumes, cover letters, portfolio attachments) associated with opportunities; supports docx, doc, pdf, txt, jpg, png.

Lever Resumes API

Read parsed resume data — work history, education, skills — extracted from candidate submissions.

Lever Users API

Manage Lever users and their access roles (Super Admin, Admin, Team Member, Limited Team Member, Interviewer, Outsider).

Lever Audit Events API

Read tenant-scoped audit events for security monitoring and SOC reporting.

Lever EEO API

Read anonymous EEO survey data for compliance reporting; PII-isolated from the standard candidate endpoints.

Lever Webhooks API

Subscribe to Lever events (applicationCreated, candidateHired, stageChange, contactUpdate). Events are signed with HMAC-SHA256 for receiver verification.

Lever Postings Public API

The unauthenticated public Postings API for retrieving live job listings from a Lever account, used by external careers pages.

Lever XML Feed

XML feed of open postings used by job aggregators (Indeed, Glassdoor, LinkedIn) for syndication.

Collections

Lever API

OPEN

GraphQL

Lever GraphQL Schema

This document describes a conceptual GraphQL schema for the Lever ATS (Applicant Tracking System) API. Lever's production API is REST-based (https://api.lever.co/v1), but this s...

GRAPHQL

Pricing Plans

Lever Plans Pricing

4 plans

PLANS

Rate Limits

Lever Rate Limits

4 limits

RATE LIMITS

FinOps

Lever Finops

FINOPS

Features

REST API at https://api.lever.co/v1 (JSON over HTTPS)

Basic Auth (API key) and OAuth 2.0 for partner apps

10 requests/second per API key with burst to 20 req/s (token bucket)

Pagination via limit (1-100) and cursor-based offset tokens

include / expand parameters for projection and inline expansion

HMAC-SHA256 signed webhook events

Public Postings API for unauthenticated job-listing retrieval

XML feed for aggregator syndication

Custom-quoted SaaS pricing — no public price list

Resources

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Lever API
  version: v1
request:
  auth:
    type: basic
    username: '{{username}}'
    password: '{{password}}'
items:
- info:
    name: Opportunities
    type: folder
  items:
  - info:
      name: List opportunities
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities
    docs: List opportunities
  - info:
      name: Create opportunity
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/opportunities
      body:
        type: json
        data: '{}'
    docs: Create opportunity
  - info:
      name: List deleted opportunities
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/deleted
    docs: List deleted opportunities
  - info:
      name: Retrieve opportunity
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: Retrieve opportunity
  - info:
      name: Update stage
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/stage
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Update stage
  - info:
      name: Update archived state
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/archived
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Update archived state
  - info:
      name: Update contact links
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/links
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Update contact links
  - info:
      name: Update tags
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/tags
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Update tags
  - info:
      name: Update sources
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/sources
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Update sources
  - info:
      name: List candidates (deprecated)
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/candidates
    docs: List candidates (deprecated)
  - info:
      name: Retrieve candidate (deprecated)
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/candidates/:candidate
      params:
      - name: candidate
        value: ''
        type: path
    docs: Retrieve candidate (deprecated)
- info:
    name: Applications
    type: folder
  items:
  - info:
      name: List applications for opportunity
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/applications
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List applications for opportunity
  - info:
      name: Retrieve application
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/applications/:application
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      - name: application
        value: ''
        type: path
    docs: Retrieve application
- info:
    name: Notes
    type: folder
  items:
  - info:
      name: List notes
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/notes
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List notes
- info:
    name: Feedback
    type: folder
  items:
  - info:
      name: List feedback forms
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/feedback
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List feedback forms
  - info:
      name: Create feedback form
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/opportunities/:opportunity/feedback
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Create feedback form
  - info:
      name: Retrieve feedback form
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/feedback/:feedback
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      - name: feedback
        value: ''
        type: path
    docs: Retrieve feedback form
  - info:
      name: Update feedback form
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/opportunities/:opportunity/feedback/:feedback
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      - name: feedback
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update feedback form
  - info:
      name: Delete feedback form
      type: http
    http:
      method: DELETE
      url: https://api.lever.co/v1/opportunities/:opportunity/feedback/:feedback
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      - name: feedback
        value: ''
        type: path
    docs: Delete feedback form
- info:
    name: Forms
    type: folder
  items:
  - info:
      name: List forms
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/forms
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List forms
  - info:
      name: List profile forms
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/profile_forms
    docs: List profile forms
- info:
    name: Files
    type: folder
  items:
  - info:
      name: List files
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/files
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List files
  - info:
      name: Upload file
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/opportunities/:opportunity/files
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
      body:
        type: json
        data: '{}'
    docs: Upload file
  - info:
      name: List file actions
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/file-actions
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List file actions
- info:
    name: Resumes
    type: folder
  items:
  - info:
      name: List resumes
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/resumes
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List resumes
- info:
    name: Interviews
    type: folder
  items:
  - info:
      name: List interviews
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/interviews
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List interviews
  - info:
      name: List interview panels
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/panels
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List interview panels
- info:
    name: Offers
    type: folder
  items:
  - info:
      name: List offers
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/opportunities/:opportunity/offers
      params:
      - name: opportunity
        value: ''
        type: path
        description: Opportunity identifier (UUID).
    docs: List offers
- info:
    name: Contacts
    type: folder
  items:
  - info:
      name: Retrieve contact
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/contacts/:contact
      params:
      - name: contact
        value: ''
        type: path
    docs: Retrieve contact
  - info:
      name: Update contact
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/contacts/:contact
      params:
      - name: contact
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update contact
- info:
    name: Postings
    type: folder
  items:
  - info:
      name: List postings
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/postings
    docs: List postings
  - info:
      name: Create posting
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/postings
      body:
        type: json
        data: '{}'
    docs: Create posting
  - info:
      name: Retrieve posting
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/postings/:posting
      params:
      - name: posting
        value: ''
        type: path
    docs: Retrieve posting
  - info:
      name: Update posting
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/postings/:posting
      params:
      - name: posting
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update posting
  - info:
      name: List application questions
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/postings/:posting/applications
      params:
      - name: posting
        value: ''
        type: path
    docs: List application questions
  - info:
      name: Apply to posting
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/postings/:posting/apply
      params:
      - name: posting
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Apply to posting
  - info:
      name: List users with access
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/postings/:posting/users
      params:
      - name: posting
        value: ''
        type: path
    docs: List users with access
- info:
    name: Requisitions
    type: folder
  items:
  - info:
      name: List requisitions
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/requisitions
    docs: List requisitions
  - info:
      name: Create requisition
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/requisitions
      body:
        type: json
        data: '{}'
    docs: Create requisition
  - info:
      name: Retrieve requisition
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/requisitions/:requisition
      params:
      - name: requisition
        value: ''
        type: path
    docs: Retrieve requisition
  - info:
      name: Update requisition
      type: http
    http:
      method: PUT
      url: https://api.lever.co/v1/requisitions/:requisition
      params:
      - name: requisition
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update requisition
  - info:
      name: Delete requisition
      type: http
    http:
      method: DELETE
      url: https://api.lever.co/v1/requisitions/:requisition
      params:
      - name: requisition
        value: ''
        type: path
    docs: Delete requisition
- info:
    name: Stages
    type: folder
  items:
  - info:
      name: List stages
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/stages
    docs: List stages
  - info:
      name: Retrieve stage
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/stages/:stage
      params:
      - name: stage
        value: ''
        type: path
    docs: Retrieve stage
  - info:
      name: List disposition stages
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/disposition_stages
    docs: List disposition stages
- info:
    name: ArchiveReasons
    type: folder
  items:
  - info:
      name: List archive reasons
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/archive_reasons
    docs: List archive reasons
  - info:
      name: Retrieve archive reason
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/archive_reasons/:archive_reason
      params:
      - name: archive_reason
        value: ''
        type: path
    docs: Retrieve archive reason
- info:
    name: Sources
    type: folder
  items:
  - info:
      name: List sources
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/sources
    docs: List sources
- info:
    name: Tags
    type: folder
  items:
  - info:
      name: List tags
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/tags
    docs: List tags
- info:
    name: Users
    type: folder
  items:
  - info:
      name: List users
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/users
    docs: List users
  - info:
      name: Create user
      type: http
    http:
      method: POST
      url: https://api.lever.co/v1/users
      body:
        type: json
        data: '{}'
    docs: Create user
  - info:
      name: Retrieve user
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/users/:user
      params:
      - name: user
        value: ''
        type: path
    docs: Retrieve user
- info:
    name: AuditEvents
    type: folder
  items:
  - info:
      name: List audit events
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/audit_events
    docs: List audit events
- info:
    name: EEO
    type: folder
  items:
  - info:
      name: List anonymous EEO responses
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/eeo/responses
    docs: List anonymous EEO responses
  - info:
      name: List EEO responses with PII
      type: http
    http:
      method: GET
      url: https://api.lever.co/v1/eeo/responses/pii
    docs: List EEO responses with PII
bundled: true