API Overview
The Worky platform exposes multiple REST APIs organized by domain. Each API follows OpenAPI 3.1 specification and uses JSON for request/response bodies.
| Base URL | https://api-nova-dev.worky.mx |
| Authentication | OAuth 2.0 Bearer Token |
| Content Type | application/json |
| API Version | v1 (current) |
Available APIs
Click on any API to view its complete Swagger documentation:
Directory
Employee master data, vacancies, contracts, and organizational records
31 controllers
View API →Catalogs
System lookup tables including banks, tax tables, locations, and job positions
100+ controllers
View API →HR
Onboarding, policies, requests, and HR processes
9 controllers
View API →Payroll
Payroll calculations, calendars, concepts, and periods
18 controllers
View API →Time Off
PTO events, balances, and time-off policies
8 controllers
View API →Incidences
HR incidences, approval flows, and event policies
15 controllers
View API →Time & Attendance
Shifts, schedules, and attendance policies
8 controllers
View API →Users
User management, authentication, and permissions
2 controllers
View API →ID Provider
Single Sign-On (SSO) and identity management
5 controllers
View API →Common Response Codes
| Code | Status | Description |
|---|---|---|
200 | OK | Request successful |
201 | Created | Resource created successfully |
400 | Bad Request | Invalid request parameters |
401 | Unauthorized | Missing or invalid authentication |
403 | Forbidden | Insufficient permissions |
404 | Not Found | Resource not found |
422 | Unprocessable Entity | Validation error |
500 | Server Error | Internal server error |