{"uid":"cap_RQxSrFsX-rA4N3Ir1OBsw","slug":"farsi-tools-iranian-official-jalali-holidays-3d6124d3","name":"Farsi Tools - Iranian Official Jalali Holidays","description":"Persian (Farsi) and Iranian utility API for AI agents. Text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, Iranian national ID / Sheba (IBAN) / mobile / landline / postal code / bank card (Luhn PAN) / company ID / economic code validators, Iranian provinces and cities, official Jalali holidays, Rial-Toman conversion. Also a FIXED-PRICE deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file (not per call) - upload a CSV, TSV or text file and get it back normalized, with an optional Latin transliteration column. Pay per request in USDC on Base via x402 - no signup, no API key, no KYC.","url":"https://farsi-tools.johnaio281.workers.dev/api/fa/iran-holidays?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":["year"],"properties":{"year":{"type":"integer","maximum":1500,"minimum":1300}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":1405,"holidays":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_njJ2XK6BYuq-dnLOg499j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of official Iranian public holidays for a given Jalali (Solar Hijri) year","exampleAgentPrompt":"Can you get me the list of all official Iranian public holidays for Jalali year 1404?","exampleUseCases":[{"title":"Scheduling around Iranian holidays","prompt":"I'm planning a project timeline for our Iranian office — can you pull up all the official public holidays in Iran for Jalali year 1404 so I know which days to skip?"},{"title":"Checking Nowruz and other national holiday dates","prompt":"What are all the national holidays in Iran this Jalali year, 1403? I want to see the full list of official days off."},{"title":"Automating Iranian business calendar","prompt":"Build me a business-day calculator for Iran — first fetch the official government holidays for Jalali year 1405 so I can exclude them from working day counts."}],"resultDescription":"A JSON object containing the queried Jalali year and an array of official Iranian public holidays, including holiday names and their corresponding Jalali calendar dates for that year.","failureModes":["Year parameter missing or out of allowed range (1300–1500) returns a validation error","Network timeout on the Cloudflare Workers edge","Payment not processed via x402 returns HTTP 402","Invalid year type (non-integer) rejected by schema validation"],"whenToPreferThis":"Use this endpoint when you need authoritative Iranian official public holiday data keyed to the Jalali (Solar Hijri) calendar year. It is specifically designed for Persian/Iranian calendar contexts, unlike generic holiday APIs that only support Gregorian calendars. Prefer this when building scheduling tools, business day calculators, or calendars for Iranian users, or when integrating with other farsi-tools endpoints for a full Iranian calendar solution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:56.933Z","isFirstParty":false,"canonicalSlug":"farsi-tools-iranian-official-jalali-holidays-3d6124d3"}