API Documentation

Build powerful integrations with LeavePlan's robust API. Complete access to all PTO management features.

🔌

RESTful API

Clean, predictable REST endpoints with JSON responses

🔔

Webhooks

Real-time notifications for request approvals, denials, and balance changes

🔐

OAuth 2.0

Secure authentication using industry-standard OAuth 2.0

📦

SDKs

Official SDKs for JavaScript, Python, and Ruby

Core API Endpoints

GET

/api/v1/employees

Retrieve all employees with their PTO balances

Employees

POST

/api/v1/requests

Create a new time-off request

Requests

GET

/api/v1/requests/:id

Get details of a specific time-off request

Requests

PUT

/api/v1/requests/:id/approve

Approve a pending time-off request

Approvals

GET

/api/v1/policies

List all PTO policies configured in your organization

Policies

POST

/api/v1/balances/adjust

Manually adjust an employee's PTO balance

Balances

Quick Start

Authentication

curl https://api.leaveplan.com/v1/employees \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a Request

curl -X POST https://api.leaveplan.com/v1/requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "emp_123",
    "start_date": "2025-10-15",
    "end_date": "2025-10-19",
    "type": "vacation"
  }'

Ready to Start Building?

Get your API key and start integrating LeavePlan into your systems today.

Get API Access

Free tier includes 10,000 API calls per month