# Hijri Calendar Converter API

> For the complete documentation index, see [llms.txt](/llms.txt).

Convert between Gregorian and Hijri (Islamic) dates with month names, sacred-month and leap-year flags.

Use this endpoint to add the tool to your app, site, workflow, or agent without rebuilding formulas, validation, examples, and docs.

- Slug: `hijri-calendar-converter`
- Category: `time-date`
- Version: `2026-04-22`
- Credits per successful call: 1
- Starts on: free
- Max payload: 65536 bytes
- Privacy mode: `hash_only`
- Available on: free, starter, pro, business, scale
- Browser tool: https://miniwebtool.com/hijri-calendar-converter/

## Endpoint

`POST https://api.miniwebtool.com/v1/tools/hijri-calendar-converter/run`

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `direction` | `str` | no | gregorian_to_hijri | hijri_to_gregorian Choices: gregorian_to_hijri, hijri_to_gregorian |
| `gregorian_date` | `str` | no | ISO date, used one way |
| `hijri_year` | `int` | no | Hijri year, used the other way |
| `hijri_month` | `int` | no | Hijri month 1-12 |
| `hijri_day` | `int` | no | Hijri day 1-30 |

## Example request

```json
{
  "direction": "gregorian_to_hijri",
  "gregorian_date": "2026-07-30",
  "hijri_year": 1448,
  "hijri_month": 1,
  "hijri_day": 1
}
```

## cURL

```bash
curl -X POST https://api.miniwebtool.com/v1/tools/hijri-calendar-converter/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"direction":"gregorian_to_hijri","gregorian_date":"2026-07-30","hijri_year":1448,"hijri_month":1,"hijri_day":1}'
```

## Response envelope

```json
{
  "request_id": "01K...",
  "tool": "hijri-calendar-converter",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {}
}
```

## Errors

Errors are RFC 7807 `application/problem+json`. Branch on `code`, not `title`.

## MCP

Agents can discover and call this tool through `https://api.miniwebtool.com/mcp` or `https://api.miniwebtool.com/v1/mcp` using MCP `tools/list` and `tools/call`.

## Frequently asked

### What does the Hijri Calendar Converter API do?

Convert between Gregorian and Hijri (Islamic) dates with month names, sacred-month and leap-year flags. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

### How much does one call cost?

1 credit per successful call. Failed calls do not bill.

### What parameters are required?

Required fields: (none). Full schema at `https://api.miniwebtool.com/v1/openapi.json`.

### Is this deterministic?

Yes. Same input, same output. Tool version: 2026-04-22.