# Welcome to the AbsenceSoft API

**Extend our purpose-built leave and accommodations platform into your HR ecosystem** The AbsenceSoft API enables you to automate leave and accommodations workflows, synchronize employee data, and maintain compliance through secure, well-documented REST endpoints. #### What You Can Do: - Sync employee data across systems - Manage leave cases programmatically - Retrieve comprehensive leave records - Perform bulk updates efficiently - Automate communications #### Common Integrations: - Workday - UKG - Paylocity - Custom HRIS platforms - Time & attendance systems

![AbsenceSoft integrating with multiple HR systems](https://absencesoft.com/wp-content/uploads/2024/08/integrations-page-header.png)

--- ## Getting Started

### 1. Authenticate All API requests require OAuth2 bearer tokens. We support both password grant flow (user authentication) and client credentials flow (service-to-service integration). [View Complete Authentication Guide →](https://absencesoft.stoplight.io/docs/api-specs/9a6663fa33b17)

```bash curl -X POST \ "https://auth.absencetracker-api.com/oauth2/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" ```

### 2. Make Your First Request Once authenticated, retrieve an employee's information using their employee number. The response includes demographics, employment status, contact information, and organizational hierarchy.

```bash curl -X GET \ "https://employee.absencetracker-api.com/api/v1/employees/{employeeNumber}" \ -H "X-AUTH-TOKEN: your_token_here" ```

--- ## Common Use Cases **Keep employee information synchronized between your HRIS and AbsenceSoft automatically.**

**What You Can Do:** - Auto-create employee records for new hires - Sync status changes, transfers, and assignments - Update contact information and addresses - Maintain organizational hierarchy

**Key Endpoints:** - [`POST /api/v1/employees`](https://absencesoft.stoplight.io/docs/api-specs/5rpsgjjkktmjj-save-employee) - Create/update employees - [`GET /api/v1/employees/{employeeNumber}`](https://absencesoft.stoplight.io/docs/api-specs/b9i5arf09kjd2-get-employee) - Get employee - [`DELETE /api/v1/employees/{employeeNumber}`](https://absencesoft.stoplight.io/docs/api-specs/c5j6129onlicp-delete-employee) - Remove employee [View Employee API Documentation →](https://absencesoft.stoplight.io/docs/api-specs/9z77dgw38eqi0)

**Create leave cases automatically and retrieve data for reporting and analytics.**

**What You Can Do:** - Auto-create cases from time-off requests - Track approvals, denials, and status changes - Retrieve case histories for compliance - Monitor work restrictions and accommodations

**Key Endpoints:** - [`POST /api/v1/cases`](https://absencesoft.stoplight.io/docs/api-specs/80eeac93153da-create-case) - Create cases - [`GET /api/v1/cases/{caseNumber}`](https://absencesoft.stoplight.io/docs/api-specs/fa58a3c0de568-read-case-details) - Get case details - [`GET /api/v1/cases/summariesbyemployee/{employeeNumber}`](https://absencesoft.stoplight.io/docs/api-specs/32aea62ee267d-get-case-summaries-by-employee) - All employee cases - [`PUT /api/v1/cases/{caseNumber}/changeDates`](https://absencesoft.stoplight.io/docs/api-specs/7c2c692bba782-update-case) - Update dates [View Case API Documentation →](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6)

--- ## API Portfolio

Our API portfolio provides programmatic access to all core AbsenceSoft functionality. Whether you're synchronizing employee data, managing leave cases, sending communications, or configuring system settings, our REST endpoints give you the flexibility to build the integration your organization needs.

### Employee API Manage employee records, contacts, and organizational structures. The [Employee API](https://absencesoft.stoplight.io/docs/api-specs/9z77dgw38eqi0) handles all employee lifecycle events from onboarding through termination, including demographic updates, contact management, and organizational hierarchy maintenance. **Base URL:** `https://employee.absencetracker-api.com` **Key Features:** - Employee CRUD operations - Contact management - Organizational hierarchy - Bulk updates

**Status:** ✅ Production **Documentation:** [API Reference →](https://absencesoft.stoplight.io/docs/api-specs/9z77dgw38eqi0) **Authentication:** OAuth2 Bearer Token **Response Format:** JSON

### Case API Manage leave and accommodations cases, work restrictions, communications, and workflows. The [Case API](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6) provides comprehensive leave case management including eligibility calculation, date modifications, accommodation requests, and time tracking. **Base URL:** `https://case.absencetracker-api.com` **Key Features:** - Case creation and updates - Accommodations and work restrictions - Time tracking and webhooks - Workflow automation

**Status:** ✅ Production **Documentation:** [API Reference →](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6) **Authentication:** OAuth2 Bearer Token **Response Format:** JSON

### Employer API Manage employer configurations, holiday schedules, and organizational settings. The [Employer API](https://absencesoft.stoplight.io/docs/api-specs/9q693pbu28phd) enables you to maintain employer-level data, configure organization policies, and manage multi-tenant environments. **Base URL:** `https://employee.absencetracker-api.com` **Key Features:** - Employer sync between systems - Holiday schedule management - Bulk updates to organizational configuration

**Status:** ✅ Production **Documentation:** [API Reference →](https://absencesoft.stoplight.io/docs/api-specs/9q693pbu28phd) **Authentication:** OAuth2 Bearer Token **Response Format:** JSON

### Communications API Send and manage case-related communications programmatically. The Communications API allows you to trigger notifications, manage templates, and track delivery status for all leave-related communications. **Base URLs:** - `https://absencetracker.com` - `https://case.absencetracker-api.com` **Key Features:** - Send communications - Manage templates - Track delivery status - Event-driven notifications

**Status:** ✨ Available Now **Documentation:** - [Communications API →](https://absencesoft.stoplight.io/docs/api-specs/z2t6v0eli9jle) - [Legacy Case API →](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6) (includes legacy communication endpoints) **Authentication:** OAuth2 Bearer Token **Response Format:** JSON

> **📋 Documentation Migration:** We've fully migrated from legacy Swagger documentation to this unified developer platform. This portal is now the authoritative source for all AbsenceSoft API documentation, containing everything previously available in Swagger plus all new AbsenceSoft API capabilities. If you've been using the legacy Swagger links, please bookmark this location as your new home for API references, guides, and integration resources. --- ## Webhooks: Event-Driven Integration

[Webhooks](https://absencesoft.stoplight.io/docs/api-specs/456b353840643) enable real-time, event-driven integration with AbsenceSoft. Instead of continuously polling our API for changes, your system receives instant HTTP notifications when specific events occur—such as case creation, status changes, or employee updates. **Key Benefits:** - Receive real-time updates the moment events occur - Eliminate unnecessary API polling - Trigger downstream workflows automatically - Maintain data consistency across platforms **Enterprise Features:** - Automatic retry with exponential backoff - Comprehensive logging and monitoring - Payload retrieval API for debugging - HTTPS-only secure delivery [Learn more about Webhooks →](https://absencesoft.stoplight.io/docs/api-specs/456b353840643)

![Real-time notifications](https://absencesoft.com/wp-content/uploads/2024/06/16000-Graphic.svg)

--- ## API Features

### Security & Reliability - HTTPS-only communication - OAuth2 authentication (password & client credentials) - Industry-standard encryption - SOC 2 certified infrastructure - Enterprise-grade reliability - High-volume integration support

### Developer Experience - RESTful design with predictable URLs - Standard HTTP methods (GET, POST, PUT, DELETE) - JSON request/response format - Comprehensive error messages - Real-time synchronization - Webhook support for event-driven workflows

--- ## Integration Best Practices

### Authentication & Security - Store credentials in environment variables or secret management - Rotate tokens regularly - Use HTTPS exclusively (enforced by default) - Implement proper error handling for auth failures (see [Troubleshooting](https://absencesoft.stoplight.io/docs/api-specs/28a388cc2dd67)) ### Data Handling - Validate data before sending requests - Handle API responses gracefully - Use pagination for large datasets - Implement retry logic with exponential backoff

### Integration Design - Test thoroughly in staging before production - Monitor API usage and implement logging - Document your integration architecture - Use [Webhooks](https://absencesoft.stoplight.io/docs/api-specs/456b353840643) for event-driven workflows to reduce polling ### Performance Optimization - Cache frequently accessed, rarely changing data - Batch operations when possible - Implement rate limiting awareness - Use conditional requests (ETag headers) where supported

--- ## Understanding APIs **What is an API?** An Application Programming Interface (API) is a set of rules that allows different software applications to communicate automatically.

![Employee API](https://absencesoft.com/wp-content/uploads/2025/10/mm-star.svg)
**[Employee API](https://absencesoft.stoplight.io/docs/api-specs/9z77dgw38eqi0)** Always have the latest employee data across your systems. Add, update, or retrieve employee information without manual data entry, keeping your leave team focused on supporting employees.

![Case API](https://absencesoft.com/wp-content/uploads/2025/10/mm-case.svg)
**[Case API](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6)** Manage leave and accommodations in or out of our UI. External systems can submit, track, and update cases programmatically while maintaining compliance.

![Webhooks](https://absencesoft.com/wp-content/uploads/2025/10/mm-network.svg)
**[Webhooks](https://absencesoft.stoplight.io/docs/api-specs/456b353840643)** Stay informed in real-time. Systems receive instant updates when events occur, like case status changes, enabling immediate, personalized responses.

--- ## Support & Resources

Our team is here to help you succeed with your AbsenceSoft integration. Whether you're troubleshooting an authentication issue, looking for code examples, or planning your integration architecture, we're ready to assist.

### Get Technical Assistance Stuck on an integration challenge? Our support team can help with authentication issues, endpoint questions, error troubleshooting, and architecture guidance. **Email:** support@absencesoft.com **Subject:** API Support - [Your Issue] **We Can Help With:** - Authentication and authorization issues - Endpoint-specific questions and examples - Error troubleshooting and debugging - Integration architecture guidance - Best practices and performance optimization ### Join Our Developer Community Connect with other developers, share integration patterns, and get answers to common questions from peers who are building with the AbsenceSoft API. **Visit:** [community.absencesoft.com →](https://community.absencesoft.com/) **Community Benefits:** - Share integration patterns and solutions - Get answers from experienced developers - Learn about new API features and updates - Collaborate on integration challenges - Access community-contributed code examples ### Help Us Improve Your feedback helps us make our API documentation better for everyone. We welcome suggestions, corrections, and requests for additional content. **Email:** support@absencesoft.com **Subject:** API Documentation Feedback **What to Share:** - Report unclear or missing information - Request additional code examples - Suggest new tutorials or use cases - Identify errors or outdated content - Share what's working well ### API Documentation **API Documentation:** - [Employee API →](https://absencesoft.stoplight.io/docs/api-specs/9z77dgw38eqi0) - [Case API (Legacy) →](https://absencesoft.stoplight.io/docs/api-specs/3761014dbb9a6) - [Case API →](https://absencesoft.stoplight.io/docs/api-specs/gqr0aw797p15u) - [Communications API →](https://absencesoft.stoplight.io/docs/api-specs/z2t6v0eli9jle) - [Authentication Guide →](https://absencesoft.stoplight.io/docs/api-specs/9a6663fa33b17) --- > **🚀 Ready to Start Building?** Grab your Portal credentials, review the authentication guide, and choose your first API above to start integrating AbsenceSoft's leave and accommodations platform into your HR technology ecosystem today.