API Reference
The HR Instance REST API lets you integrate employee, leave, attendance, and payroll data with your existing tools.
Base URL
https://api.hrinstance.comRate Limit
100 req / min
5,000 req / hour per API key
Version
v1 (stable)
All endpoints prefixed with /api/v1/
Authentication
All API requests must include a Bearer token in the Authorization header. Obtain tokens via the login endpoint or generate API keys from Settings → API Keys in your dashboard.
# Example request with Bearer token
curl -X GET \
https://api.hrinstance.com/api/v1/employees \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Retry-After header for the wait time. Enterprise plans support higher limits — contact us.Response Format
All responses are JSON. Successful responses include a data field. Errors include error and message.
// Success (200)
{ "data": [{ "id": "emp_01", "name": "Priya Sharma", ... }], "total": 248, "page": 1 }
// Error (401)
{ "error": "UNAUTHORIZED", "message": "Invalid or expired Bearer token." }
Endpoints
/api/v1/employees/api/v1/employees/api/v1/employees/:id/api/v1/employees/:id/api/v1/employees/:id/api/v1/leaves/api/v1/leaves/api/v1/leaves/:id/approve/api/v1/leaves/:id/reject/api/v1/attendance/api/v1/attendance/checkin/api/v1/attendance/checkout/api/v1/payroll/api/v1/payroll/run/api/v1/payroll/:id/payslipError Codes
Need API Access or Higher Rate Limits?
Enterprise plans include dedicated API keys and custom rate limits. Contact us for integration support.
Request API Access