We use cookies

PDPL Compliant

We use cookies to enhance your experience on our website. Some are essential for the site to function, while others help us understand how you use the site.

Sovereign Spotlight

Search across all modules, people, and actions

Critical Compliance Alerts

8
Total Penalty Exposure:
5,249,500 SAR

No Pending Alerts

All regulatory requirements are up to date

3 critical8 pending

API Documentation

Comprehensive Integration Guide for AqlHR Platform

Version: 1.0.0Last Updated: January 3, 2026
Base URL
https://api.aqlhr.ai/v1

All API requests use this base URL

Content Type
application/json

All requests and responses are in JSON format

Encryption
TLS 1.3

All communications encrypted with TLS 1.3

Response Format

Success Response

{
  "success": true,
  "data": {
    "employees": [
      {
        "id": "emp_123",
        "nameAr": "أحمد محمد",
        "nameEn": "Ahmed Mohammed",
        "email": "[email protected]",
        "department": "Engineering",
        "position": "Senior Developer",
        "status": "active",
        "joinDate": "2024-01-15",
        "createdAt": "2024-01-15T08:00:00Z",
        "updatedAt": "2024-01-20T14:30:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "totalPages": 8
    }
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-25T10:30:00Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ]
  },
  "meta": {
    "requestId": "req_xyz789",
    "timestamp": "2024-01-25T10:30:00Z"
  }
}
HTTP Status Codes
CodeStatusDescription
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestInvalid request parameters
401UnauthorizedAuthentication required
403ForbiddenAccess denied
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error