{"uid":"cap_IOHHFmTCNknxegqo6N36H","slug":"irantools-iran-public-holidays-519c4ab9","name":"IranTools Iran Public Holidays","description":"Persian and Iranian utilities for AI agents, plus general text/Unicode tooling. Jalali (Solar Hijri) calendar conversion, Iranian national ID / SHEBA / bank card / postal code / economic code validation, province and city lookup, official public holidays, Persian text normalization, keyword extraction, sentence splitting, similarity, HTML stripping, RTL fixing, Unicode homoglyph folding, script detection, NFC/NFD normalization, grapheme counting, date description, business-day counting, slugify, FNV-1a hashing, Shannon entropy, format and encoding detection, byte sizes. Pay per call in USDC on Base via x402 - no signup, no API key, no KYC. The same tools are also exposed as MCP tools at /mcp.","url":"https://irantools.johnaio281.workers.dev/api/iran/iran_holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["year"],"properties":{"year":{"type":"string"}}},"responseSchema":{"type":"object","additionalProperties":true},"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_jxwKPvZVNi7XiJoiPpe_S","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 official Iranian public holidays for a given Jalali (Solar Hijri) calendar year","exampleAgentPrompt":"What are all the official public holidays in Iran for Jalali year 1403?","exampleUseCases":[{"title":"Business scheduling around Iranian holidays","prompt":"I'm planning a project timeline for our Iran office — can you pull all the official public holidays for Jalali year 1403 so I know which days to avoid scheduling meetings?"},{"title":"Travel planning for Iran","prompt":"I'm visiting Iran next year (1403 in the Iranian calendar) — can you get me the full list of public holidays so I can plan around festivals and closures?"},{"title":"HR payroll calendar for Iranian employees","prompt":"I need to set up our payroll calendar for Iranian staff — can you fetch all the official government holidays for Jalali year 1402 so we can flag non-working days?"}],"resultDescription":"Returns a structured list of official Iranian public holidays for the requested Jalali year, including holiday names and their corresponding dates in the Solar Hijri calendar.","failureModes":["Missing required 'year' field returns a validation error","Invalid or non-numeric year string may return an error or empty result","Years outside the supported range may return an empty list or error","Payment failure (insufficient USDC balance) results in HTTP 402 before processing"],"whenToPreferThis":"Use this endpoint when you need authoritative Iranian public holiday data keyed to a Jalali year, especially for scheduling, HR, travel, or compliance use cases involving Iran. Prefer this over manual lookup or general LLM knowledge when accuracy and up-to-date official holiday lists are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:51.955Z","isFirstParty":false,"canonicalSlug":"irantools-iran-public-holidays-519c4ab9"}