Documentation

Holidays

Read the organization holiday calendar.

Requires scope: holidays

Defaults to the current calendar year.

Endpoints

GET/api/v1/integrations/holidaysBearer auth

List holidays

Query: year, month, type, isActive, page, limit

Example response

{
  "success": true,
  "status": 200,
  "data": {
    "holidays": [
      {
        "id": "665f1a2b3c4d5e6f7a8b9c88",
        "name": "Republic Day",
        "date": "2026-01-26T00:00:00.000Z",
        "type": "national",
        "isActive": true,
        "description": null
      }
    ],
    "pagination": { "page": 1, "limit": 50, "total": 1, "pages": 1 }
  }
}

GET/api/v1/integrations/holidays/:idBearer auth

Get one holiday

Example response

{
  "success": true,
  "status": 200,
  "data": {
    "holiday": {
      "id": "665f1a2b3c4d5e6f7a8b9c88",
      "name": "Republic Day",
      "date": "2026-01-26T00:00:00.000Z",
      "type": "national",
      "isActive": true,
      "description": null
    }
  }
}