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
Catalogs
System lookup tables including banks, tax tables, locations, and job positions
Business Structures
Organizational structure APIs for departments, areas, and hierarchy setup
HR
Onboarding, policies, requests, and HR processes
Payroll
Payroll calculations, calendars, concepts, and periods
Time Off
PTO events, balances, and time-off policies
Incidences
HR incidences, approval flows, and event policies
Time & Attendance
Shifts, schedules, and attendance policies
Punches
Punch-specific endpoints for attendance capture and validations
Users
User management, authentication, and permissions
ID Provider
Single Sign-On (SSO) and identity management
Accounts
Account-level configuration, profile, and platform setup operations
Fintech
Financial operations and integrations for payment-related workflows
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 |