# Lever Developer API Documentation & Integration Guide

> **Public REST API:** Available  
> **Official Docs:** https://developer.lever.co  
> **Webhook Support:** Yes  
> **Authentication Methods:** API Key, OAuth 2.0  
> **Target Market:** SMB  

---

## 1. API Architecture & Summary
Lever provides REST APIs and real-time webhook triggers for candidate stages, notes, postings, and interview schedules.

## 2. Authentication
Requests to the Lever API require authentication via API Key or OAuth 2.0.
Headers typically required:
```http
Authorization: Basic YOUR_ENCODED_KEY
Content-Type: application/json
```

## 3. Code Samples

### cURL
```bash
# List jobs or candidate submissions from Lever
curl -X GET "https://api.lever.io/v1/candidates" \
  -H "Authorization: Basic YOUR_ENCODED_KEY" \
  -H "Accept: application/json"
```

### Python (httpx)
```python
import httpx

headers = {
    "Authorization": "Basic YOUR_ENCODED_KEY",
    "Accept": "application/json"
}

response = httpx.get("https://api.lever.io/v1/candidates", headers=headers)
print(response.json())
```

### TypeScript / Node.js
```typescript
async function fetchCandidates() {
  const res = await fetch("https://api.lever.io/v1/candidates", {
    headers: {
      "Authorization": "Basic YOUR_ENCODED_KEY",
      "Accept": "application/json",
    },
  });
  const data = await res.json();
  console.log(data);
}
```

## 4. Webhook Event Notifications
Lever supports real-time event webhooks (e.g. `candidate.created`, `application.updated`, `stage.changed`). Endpoints should return HTTP 200 within 3 seconds.

---
*Generated by Redraft ATS Intelligence (https://resumepure.com)*