# UAE Holidays



The UAE public holiday calendar, and a working-day check derived from it.



## UAE Holidays

The UAE's public holidays — Eid Al Fitr, Arafah Day, Eid Al Adha, National Day — with moon-dependent dates kept visibly provisional.

- Method: `GET`
- Path: `/v1/holidays/uae`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `year` | integer | optional | A year outside the covered range is a 404, never an empty list. |

**Example request**

```bash
curl https://api.diraz.ae/v1/holidays/uae \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "covered_years": [2026],
    "holidays": [
      { "date": "2026-01-01", "name": "Gregorian New Year", "type": "national", "confirmed": true },
      { "date": "2026-03-20", "name": "Eid Al Fitr", "type": "national", "confirmed": false },
      { "date": "2026-05-26", "name": "Arafah Day", "type": "national", "confirmed": false },
      { "date": "2026-12-02", "name": "National Day (Eid Al Etihad)", "type": "national", "confirmed": true }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```

## UAE Working Day Check

Is this date a working day in the UAE? Weekends are Saturday and Sunday; holidays are the public calendar.

- Method: `GET`
- Path: `/v1/holidays/uae/check`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `date` | string | required | `YYYY-MM-DD`. |

**Example request**

```bash
curl https://api.diraz.ae/v1/holidays/uae/check \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "date": "2026-12-02",
    "weekday": "Wednesday",
    "is_weekend": false,
    "is_holiday": true,
    "is_working_day": false,
    "holidays": [
      { "date": "2026-12-02", "name": "National Day (Eid Al Etihad)", "type": "national", "confirmed": true }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```