# Indonesian Holidays



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



## Indonesian Holidays

Public holidays and cuti bersama, kept apart — because payroll, SLAs, and couriers treat them differently.

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

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `year` | integer | optional | A year outside the covered range is a 404, never an empty list. |
| `type` | string | optional | `national` for a public holiday, `joint_leave` for cuti bersama. |

**Example request**

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

**Example response**

```json
{
  "data": {
    "covered_years": [2026],
    "holidays": [
      { "date": "2026-03-21", "name": "Hari Idul Fitri", "type": "national", "confirmed": true },
      { "date": "2026-03-23", "name": "Cuti Bersama Idul Fitri", "type": "joint_leave", "confirmed": true },
      { "date": "2026-05-31", "name": "Hari Raya Waisak", "type": "national", "confirmed": false }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```

## Working Day Check

Is this a working day? Folds weekend, public holiday, and cuti bersama into the one answer payroll and delivery estimates actually need.

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

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `date` | string | required | `YYYY-MM-DD`. A date that does not exist is rejected rather than rolled over. |

**Example request**

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

**Example response**

```json
{
  "data": {
    "date": "2026-08-17",
    "weekday": "Monday",
    "is_weekend": false,
    "is_holiday": true,
    "is_joint_leave": false,
    "is_working_day": false,
    "holidays": [
      {
        "date": "2026-08-17",
        "name": "Hari Proklamasi Kemerdekaan R.I.",
        "type": "national",
        "confirmed": true
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```