# Hijri Calendar

Convert between Hijri and Gregorian dates in either direction, with Indonesian month and weekday names.

- Method: `GET`
- Path: `/v1/calendar/hijri`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `date` | string | optional | Gregorian `YYYY-MM-DD` to convert forwards. |
| `hijri` | string | optional | Hijri `YYYY-MM-DD` to convert backwards. |

**Example request**

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

**Example response**

```json
{
  "data": {
    "gregorian": { "date": "2026-08-19", "weekday": "Wednesday", "weekday_id": "Rabu" },
    "hijri": {
      "date": "1448-03-06",
      "year": 1448,
      "month": 3,
      "month_name": "Rabi' al-Awwal",
      "month_name_id": "Rabiul Awal",
      "day": 6
    },
    "note": "Converted with the tabular Islamic calendar. Indonesia determines months by hisab and rukyat, so an observed date may differ by a day."
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```