# Persian Solar Hijri Calendar Converter

> Persian Solar Hijri Calendar Converter is a paid API for AI agents from calendar-systems.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Converts a Gregorian date to the Persian Solar Hijri calendar (or vice versa) using the astronomical Nowruz rule, covering years 1901–2100.

## Facts

- Endpoint: GET https://calendar-systems.x402tookit.com/persian-calendar?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/persian-solar-hijri-calendar-converter-a4e1a2cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SswCcpdXwp0KbpDKMkvE2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability persian-solar-hijri-calendar-converter-a4e1a2cd
```

Example prompt: What is March 20, 2025 in the Persian Solar Hijri calendar? Use the Gregorian input direction and tell me the Persian month name, whether it's a leap year, and when Nowruz falls.

## When to prefer this

Choose this endpoint when you need precise astronomical Persian Solar Hijri (Jalali/Shamsi) date conversion based on the Nowruz rule rather than a tabular approximation. It is specifically designed for the Persian calendar (not Islamic Hijri or Hebrew), supports bidirectional conversion, and provides rich metadata including leap year status, month lengths, and Nowruz dates — making it ideal for cultural apps, Iranian-audience localization, and date enrichment pipelines.

## Known failure modes

- Date outside supported range 1901–2100 returns unsupported flag or error
- Invalid date format (not YYYY-MM-DD) returns validation error
- Invalid 'from' enum value returns bad request
- Persian date that doesn't exist (e.g. day 30 in a 29-day month) may return error or degraded response
- Network or payment failure returns HTTP 402 or 5xx

## How this service works

Convert a Gregorian date to the Persian Solar Hijri calendar (or back) using the astronomical Nowruz rule, 1901-2100.

## Output

Returns a JSON object with the full Persian date breakdown (year, month, day, month name, leap year status, year length, month length, Nowruz date in Gregorian, next Nowruz date) alongside the corresponding Gregorian date components (year, month, day, ISO string, weekday) and metadata such as source, asOf timestamp, summary, and disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD, in the Gregorian calendar (default) or in the persian calendar when from=persian"
      },
      "from": {
       "enum": [
        "gregorian",
        "persian"
       ],
       "type": "string",
       "description": "gregorian (default) or persian: which calendar the date is written in"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "from": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "persian": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "day": {
         "type": [
          "null",
          "number"
         ]
        },
        "text": {
         "type": [
          "null",
          "string"
         ]
        },
        "year": {
         "type": [
          "null",
          "number"
         ]
        },
        "input": {
         "type": [
          "null",
          "string"
         ]
        },
        "month": {
         "type": [
          "null",
          "number"
         ]
        },
        "leapYear": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "monthName": {
         "type": [
          "null",
          "string"
         ]
        },
        "yearLengthDays": {
         "type": [
          "null",
          "number"
         ]
        },
        "monthLengthDays": {
         "type": [
          "null",
          "number"
         ]
        },
        "nowruzGregorian": {
         "type": [
          "null",
          "string"
         ]
        },
        "nextNowruzGregorian": {
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/persian-solar-hijri-calendar-converter-a4e1a2cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from calendar-systems.x402tookit.com](https://www.zero.xyz/host/calendar-systems.x402tookit.com/llms.txt)