Get Template Holidays

openapi: 3.1.0
info:
  title: Get Template Holidays
  version: 1.0.0

paths:
  /api/holiday-lists/templates/{region}:
    get:
      summary: Retrieve template holidays
      description: Returns a predefined list of holidays for the specified region.
      tags:
        - Holiday Lists

      security:
        - bearerAuth: []

      parameters:
        - in: path
          name: region
          required: true
          schema:
            type: string
          example: india

      responses:
        "200":
          description: Holiday template retrieved successfully.

        "400":
          description: Invalid region.

        "401":
          description: Unauthorized.

        "404":
          description: Region not found.

        "500":
          description: Internal Server Error.

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

curl --location '{{baseUrl}}/api/holiday-lists/templates/india' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "region": "india",
    "holidays": [
      {
        "name": "Republic Day",
        "date": "2026-01-26"
      },
      {
        "name": "Independence Day",
        "date": "2026-08-15"
      },
      {
        "name": "Gandhi Jayanti",
        "date": "2026-10-02"
      }
    ]
  }
}

{
  "success": false,
  "message": "Invalid region supplied."
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Holiday template not found for the specified region."
}

{
  "success": false,
  "message": "Failed to retrieve holiday template."
}