For Agents
Search opportunities, advance candidates through pipeline stages, schedule interviews, and retrieve hiring analytics from a Lever recruiting account.
Get started with Lever API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"list candidates in interview stage"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Lever API API.
Search and filter candidate opportunities by stage, source, or posting
Advance or archive candidates through configurable pipeline stages
Attach interview feedback, scorecards, and notes to candidate profiles
Post and manage job listings with requisition-linked approval workflows
Schedule interview panels and retrieve interviewer availability
GET STARTED
Use for: I need to find all candidates in the interview stage, I want to advance a candidate to the next pipeline stage, List all open job postings for the Engineering team, Retrieve interview feedback for a specific opportunity
Not supported: Does not handle employee onboarding, payroll, performance reviews, or HRIS functions — use for recruiting and applicant tracking only.
Jentic publishes the only available OpenAPI document for Lever API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Lever API, keeping it validated and agent-ready. Track candidates through hiring pipelines with 53 endpoints covering opportunities, postings, interviews, offers, and feedback collection. Manage the full recruiting lifecycle from job posting through offer letter with structured access to candidate profiles, interview panels, referral sources, and requisition tracking.
Track referral sources and attribute hires to recruiting channels
Export offer details including compensation, start date, and approval status
Patterns agents use Lever API API for, with concrete tasks.
★ AI Agent Recruiting Automation
AI agents use the Lever API through Jentic to automate recruiting workflows without direct Lever credentials. An agent searches for 'advance candidate to next stage', loads the schema for the stage transition endpoint, and moves qualified candidates forward. Combined with the feedback endpoint, agents can summarize interview notes and flag candidates ready for offer.
List all opportunities in the 'Phone Screen' stage for posting ID P001, then advance the top-rated candidate to 'On-Site Interview'
Candidate Pipeline Reporting
Pull real-time pipeline metrics across all postings to feed recruiting dashboards and hiring forecasts. The opportunities endpoint supports filtering by stage, posting, creation date, and tags, enabling time-to-hire calculations, stage conversion rates, and bottleneck identification without manual data exports from the Lever UI.
Retrieve all opportunities created in the last 30 days grouped by stage and return the count at each stage for posting ID P001
Interview Coordination
Coordinate interview scheduling by accessing panel assignments, interviewer details, and feedback submissions for each opportunity. The interviews sub-resource tracks scheduled, completed, and cancelled interviews with timestamps and participant lists. Integrations connect Lever with calendar tools and video conferencing platforms to streamline the scheduling workflow.
Retrieve all scheduled interviews for opportunity ID O001 and return the interviewer names, dates, and whether feedback has been submitted
Job Posting Management
Programmatically create, update, and close job postings with linked requisitions. The postings endpoint supports full lifecycle management including publishing to job boards, setting application forms, and tracking requisition approval status. Teams use this to sync postings across multiple platforms from a single source of truth in Lever.
Create a new job posting for 'Senior Backend Engineer' linked to requisition ID R001 with the Engineering department tag
53 endpoints — jentic publishes the only available openapi specification for lever api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/opportunities
List all candidate opportunities
/opportunities/{id}
Get a specific opportunity
/opportunities/{opportunityId}/stage
Advance candidate to a stage
/opportunities/{opportunityId}/interviews
List interviews for an opportunity
/opportunities/{opportunityId}/feedback
Get feedback for an opportunity
/postings
List all job postings
/opportunities/{opportunityId}/offers
Get offers for an opportunity
/opportunities/{opportunityId}/notes
Add a note to an opportunity
/opportunities
List all candidate opportunities
/opportunities/{id}
Get a specific opportunity
/opportunities/{opportunityId}/stage
Advance candidate to a stage
/opportunities/{opportunityId}/interviews
List interviews for an opportunity
/opportunities/{opportunityId}/feedback
Get feedback for an opportunity
Three things that make agents converge on Jentic-routed access.
Credential isolation
Lever API keys and OAuth Bearer tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw API keys never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'advance candidate to next interview stage') and Jentic returns matching Lever operations with their input schemas, so the agent can call the right endpoint without reading Lever's documentation.
Time to first call
Direct Lever integration: 2-4 days for auth setup, pagination handling, and webhook configuration. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Greenhouse Harvest API
Enterprise ATS with structured candidate data, scorecards, and department-level reporting
Choose Greenhouse when the organisation uses Greenhouse as their ATS, or needs deeper scorecard and structured interview data
SmartRecruiters API
Enterprise hiring platform with marketplace integrations and AI-powered candidate matching
Choose SmartRecruiters for enterprise-scale recruiting with built-in job board distribution and vendor marketplace
Ashby API
Modern ATS with built-in analytics, scheduling, and CRM for high-growth companies
Choose Ashby when the company uses Ashby and needs native analytics and scheduling without third-party add-ons
BambooHR API
Full HRIS platform for employee records, onboarding, and time-off management
Use BambooHR alongside Lever to sync hired candidates into employee records and manage post-hire onboarding workflows
Specific to using Lever API API through Jentic.
Why is there no official OpenAPI spec for Lever API?
Lever does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Lever 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 Lever API use?
The API supports HTTP Basic authentication (API key as username, no password) and OAuth 2.0 Bearer tokens for production integrations. Basic auth is suitable for internal tools while Bearer tokens are required for partner integrations. Through Jentic, API keys are stored in the MAXsystem vault and agents authenticate without handling raw credentials.
Can I advance a candidate through pipeline stages with the Lever API?
Yes. Use POST /opportunities/{opportunityId}/stage with the target stage ID in the request body to move a candidate forward or backward in the pipeline. First retrieve available stages via GET /stages to identify valid stage IDs for the transition.
What are the rate limits for the Lever API?
Lever enforces rate limits of 10 requests per second for most endpoints. Batch list endpoints like GET /opportunities support pagination with limit and offset parameters (max 100 per page). The API returns HTTP 429 when limits are exceeded with a Retry-After header.
How do I retrieve candidate interview feedback through Jentic?
Search Jentic for 'get interview feedback for candidate', load the schema for GET /opportunities/{opportunityId}/feedback, and execute with the opportunity ID. The response includes feedback forms, ratings, and interviewer comments. Install with pip install jentic and authenticate at https://app.jentic.com/sign-up.
Does the Lever API support webhooks for real-time hiring events?
Yes. The Webhooks resource allows registering callback URLs for events including new applications, stage changes, offer extensions, and candidate archives. This enables real-time integrations with Slack notifications, onboarding systems, and HRIS platforms without polling the opportunities endpoint.
/postings
List all job postings
/opportunities/{opportunityId}/offers
Get offers for an opportunity
/opportunities/{opportunityId}/notes
Add a note to an opportunity