API Reference
Seamlessly integrate Zenchronity into your workflow. Secure, fast, and built for developers.
Getting Started
Base URL:
https://api.zenchronity.com/api/public-apiAuth header:
Authorization: Bearer YOUR_API_KEYHarness the Power of AISmart Docs
Building complex automation logic or custom middleware?
Simply paste this documentation URL into ChatGPT, Claude, or Gemini.Our metadata-rich structure allows AI models to instantly architect precise, production-ready scripts tailored specifically to your tech stack.
Security Tips
- Never expose API keys in client-side code
- Use environment variables for storage
- Rotate keys periodically
Health Check
Verify API key validity and connection status. Returns your organization code and access level.
List Users
Get a paginated list of all users. Includes profile info, department, team, and manager.
Parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Items per page (max: 100) |
status | string | Filter: active, inactive, pending |
departmentId | uuid | Filter by department |
teamId | uuid | Filter by team |
Get User
Get detailed information for a specific user by UUID.
Parameters
| Name | Type | Description |
|---|---|---|
idREQ | uuid | User UUID |
List Leave Requests
Get paginated leave requests with filtering options.
Parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number |
limit | integer | Items per page (max: 100) |
status | string | pending, approved, rejected, cancelled |
userId | uuid | Filter by user |
from | date | Start date (YYYY-MM-DD) |
to | date | End date (YYYY-MM-DD) |
Get Request
Get detailed information for a specific leave request.
Parameters
| Name | Type | Description |
|---|---|---|
idREQ | uuid | Request UUID |
List Leave Types
Get all active leave types with quota settings.
List Departments
Get all departments with hierarchy information.
List Teams
Get all teams with department associations.
Audit Logs
Get paginated audit logs with all security and business events. Includes login, leave requests, approvals, and security events.
Parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Items per page (max: 100, default: 50) |
from | date | Start date (ISO format: YYYY-MM-DD) |
to | date | End date (ISO format: YYYY-MM-DD) |
search | string | Search in message and action |
Error Handling
HTTP status codes and responses