{"uid":"cap_fasoiTPwlr7SsgbdG9mL9","slug":"farsi-tools-iran-provinces-list-e6171ed9","name":"Farsi Tools - Iran Provinces List","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-provinces?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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":31,"provinces":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_El4nRmWsK2ACqQZTjC4At","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a complete list of all Iranian provinces (ostans) with their count","exampleAgentPrompt":"Can you give me a complete list of all provinces in Iran, including their names and how many there are in total?","exampleUseCases":[{"title":"Populating a province dropdown for a form","prompt":"I'm building a registration form for Iranian users — can you fetch the full list of Iranian provinces so I can populate the province dropdown?"},{"title":"Validating a user-entered Iranian province","prompt":"A user typed 'Isfahan' as their province — can you pull the official list of Iranian provinces to check if that's a valid entry?"},{"title":"Geospatial data enrichment for Iran","prompt":"I need to enrich my database with the names of all Iranian provinces — can you retrieve the official province list from the farsi-tools API?"}],"resultDescription":"A JSON object containing the total count of provinces (31) and an array of province objects representing all Iranian administrative divisions (ostans).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:21.554Z","isFirstParty":false,"canonicalSlug":"farsi-tools-iran-provinces-list-e6171ed9"}