{"uid":"cap_SswCcpdXwp0KbpDKMkvE2","slug":"persian-solar-hijri-calendar-converter-a4e1a2cd","name":"Persian Solar Hijri Calendar Converter","description":"Convert a Gregorian date to the Persian Solar Hijri calendar (or back) using the astronomical Nowruz rule, 1901-2100.","url":"https://calendar-systems.x402tookit.com/persian-calendar?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":["null","string"]}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"weekday":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"gregorian":{"type":["null","object"],"properties":{"day":{"type":["null","number"]},"iso":{"type":["null","string"]},"year":{"type":["null","number"]},"month":{"type":["null","number"]},"weekday":{"type":["null","string"]}}},"supported":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vsIh0OIIOrPAoqvkRhelz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a Gregorian date to the Persian Solar Hijri calendar (or vice versa) using the astronomical Nowruz rule, covering years 1901–2100.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Birthday in Persian calendar","prompt":"My friend was born on September 3, 1990 in the Gregorian calendar — what is their birthday in the Persian Jalali calendar, and which Persian month does it fall in?"},{"title":"Finding Nowruz from a Persian year","prompt":"Convert the Persian date 1404-01-01 back to its Gregorian equivalent so I know the exact date of Nowruz this year."},{"title":"Software date display localization","prompt":"I'm building an app for Iranian users — can you convert 2024-12-15 from Gregorian to Persian so I can display the correct Jalali date, month name, and whether it's a leap year?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:14:22.037Z","isFirstParty":false,"canonicalSlug":"persian-solar-hijri-calendar-converter-a4e1a2cd"}