Holidays (V1)

Check if a date is a Holiday

get/api/v1/holidays/is-holiday

Request

  • Base URL: https://calendar-api.ma
  • URL: https://calendar-api.ma/api/v1/holidays/is-holiday
  • Auth: one of:
    • API key in header X-API-KEY
    • API key in cookie session

Query parameters

datestring date required

Check if this date is a Holiday

Example:2025-07-22

Response

Request fulfilled, document follows

datestring date required
is_holidayboolean required
descriptionstring required
holiday_type'ND' | 'Religious' | 'National' | 'Exceptional' required

There are Three Types of holidays:

  • Religious: Include only Religious holidays. i.e: Eid el fitr, ...
  • National: Include only National holidays. i.e: Fête du travail, Fête du trône, ...
  • Exceptional: Include only Exceptional holidays.
  • ND::Null: Disable this filter
status'ND' | 'Estimated' | 'Official' required

Represents the status of religious holidays which are based on moon sightings.

At the start of the year, Religious holydays are Estimated. When the official moon sighting is confirmed the status is changed to Official

NB: The change may shift the Estimated date by ONE DAY

All other Holiday types are Official by default

Attributes: - ND: Not defined for the entity or unknown by us (very unlikely) - Official (str): The holiday is validated and thus Official - Estimated (str): The holiday is estimated before the moon sighting

country_codestring required

Example response

{
  "holiday_type": "ND"
}

Changes

No recorded changes to this operation across all 1 revision of this API.