# Farsi Tools - Iranian Official Jalali Holidays

> Farsi Tools - Iranian Official Jalali Holidays is a paid API for AI agents from farsi-tools.johnaio281.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns the list of official Iranian public holidays for a given Jalali (Solar Hijri) year

## Facts

- Endpoint: GET https://farsi-tools.johnaio281.workers.dev/api/fa/iran-holidays?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farsi-tools-iranian-official-jalali-holidays-3d6124d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RQxSrFsX-rA4N3Ir1OBsw

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 farsi-tools-iranian-official-jalali-holidays-3d6124d3
```

Example prompt: Can you get me the list of all official Iranian public holidays for Jalali year 1404?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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": [
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "maximum": 1500,
       "minimum": 1300
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 1405,
  "holidays": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farsi-tools-iranian-official-jalali-holidays-3d6124d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from farsi-tools.johnaio281.workers.dev](https://www.zero.xyz/host/farsi-tools.johnaio281.workers.dev/llms.txt)