# Farsi Tools - Iran Provinces List

> Farsi Tools - Iran Provinces List is a paid API for AI agents from farsi-tools.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Returns a complete list of all Iranian provinces (ostans) with their count

## Facts

- Endpoint: GET https://farsi-tools.johnaio281.workers.dev/api/fa/iran-provinces?utm_source=zero.xyz
- Price: $0.003/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-iran-provinces-list-e6171ed9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fasoiTPwlr7SsgbdG9mL9

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-iran-provinces-list-e6171ed9
```

Example prompt: Can you give me a complete list of all provinces in Iran, including their names and how many there are in total?

## When to prefer this

Use this endpoint when you need an authoritative, ready-to-use list of all Iranian provinces without managing a local database or scraping. It's ideal for populating UI dropdowns, validating user input, or enriching records with Iranian geographic data. Prefer this over manual data sets when you want an up-to-date, API-served reference with no signup or API key required — just pay $0.003 per call in USDC.

## Known failure modes

- Network timeout if the Cloudflare Worker is unreachable
- Payment failure if USDC balance on Base is insufficient for the $0.003 per-call fee
- Empty provinces array returned if data is temporarily unavailable
- x402 payment protocol error if the client doesn't support micropayments

## 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 total count of provinces (31) and an array of province objects representing all Iranian administrative divisions (ostans).

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 31,
  "provinces": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farsi-tools-iran-provinces-list-e6171ed9/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)