# API Calendrier Marocain | Jours Fériés & Ouvrables REST + SDK Python

**Canonical:** https://apis.io/providers/calendar-api-ma/  
**Website:** https://calendar-api.ma  
**APIs profiled:** 3

Calendar API is a REST service from Unravel Designs (Casablanca, Morocco) that turns the Moroccan economic calendar into a callable contract. It returns national, religious and exceptional public holidays with an explicit Estimated/Official status — religious feasts are dated astronomically and only become Official after moon sighting — and it calculates open business days: next and previous working day, counts and listings between two dates, and CalSpan, a chainable business-day [start_date, end_date] interval for a month, quarter, semester or year that drops straight into a SQL BETWEEN. Fourteen read-only GET operations are described by a published OpenAPI 3.1 document, authenticated with an X-API-KEY header, and wrapped by a typed first-party Python SDK (pycalendar-api). It is aimed at data engineers wiring Moroccan holiday logic into ETL pipelines and orchestrators such as Airflow and Dagster, and at regulated-market reporting where a hardcoded holiday table quietly goes stale every year.

## Kin Score — 50.2 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 50.2).

| Facet | Score |
|---|---|
| Discoverability | 81.5 |
| Contract Quality | 56.2 |
| Governance | 16.7 |
| Contract Governance | 16.7 |
| Operational Transparency | 15.8 |
| Developer Ergonomics | 68.5 |
| Commercial Clarity | 44.7 |
| Access Clarity | 44.7 |

Regulatory layer — **Energy & Utilities**: 28.4 (matched via tags).

## Agent readiness — 37.4 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | documented |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## APIs (3)

- **API Calendrier Marocain | Jours Fériés & Ouvrables REST + SDK Python Business Days API** — National Open business days
- **API Calendrier Marocain | Jours Fériés & Ouvrables REST + SDK Python Holidays API** — National holidays of any year and Religious holidays of past years
- **API Calendrier Marocain | Jours Fériés & Ouvrables REST + SDK Python Misc API** — Misc endpoints

## Security (2)

- **Calendar Api Ma Authentication** — apiKey · 2 schemes
- **Calendar Api Ma Domain Security** — TLSv1.3

## Plans (1)

- **Calendar Api Ma Plans Pricing**

## Tags

Holidays, Morocco, Calendar, Business Days, date-utilities, Data Engineering, ETL, Python SDK, Localization, Reference Data, Public Holidays, Scheduling

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/calendar-api-ma/). Scores are computed from the provider's own public artifacts under a published rubric.