# Ashby Developer API Documentation & Integration Guide

> **Public REST API:** Available  
> **Official Docs:** https://developers.ashbyhq.com  
> **Webhook Support:** Yes  
> **Authentication Methods:** API Key  
> **Target Market:** All  

---

## 1. API Architecture & Summary
Ashby provides GraphQL and REST API access with real-time webhooks for candidates, applications, feedback submissions, and job offers.

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

## 3. Code Samples

### cURL
```bash
# List jobs or candidate submissions from Ashby
curl -X GET "https://api.ashby.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.ashby.io/v1/candidates", headers=headers)
print(response.json())
```

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

## 4. Webhook Event Notifications
Ashby 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)*