{"uid":"cap_-woe9x1FLAZciclZiKRPc","slug":"irantools-iran-provinces-list-52d345c3","name":"IranTools – Iran Provinces List","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_provinces_list?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"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_HEbaM7HCf23lrvFPOFu5f","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 the list of all Iranian provinces (استان‌ها) with their names and metadata","exampleAgentPrompt":"Can you give me a complete list of all provinces in Iran, including their Persian names?","exampleUseCases":[{"title":"Populate province dropdown for Iranian form","prompt":"I'm building a registration form for Iranian users — can you get me the full list of all Iranian provinces so I can populate the province selector?"},{"title":"Validate user-submitted province name","prompt":"A user submitted 'Khorasan' as their province — can you pull the official list of Iranian provinces and check if that matches any of them?"},{"title":"Geographic data enrichment for Iran","prompt":"I have a dataset of Iranian businesses and I need to tag each one with their province. Can you fetch the complete list of Iranian provinces so I can map them?"}],"resultDescription":"A structured list of all Iranian provinces (ostans), likely including province names in Persian and/or transliterated English, and possibly province codes or IDs used in other IranTools endpoints.","failureModes":["Payment failure if USDC balance insufficient on Base network","Network timeout from Cloudflare Worker","Unexpected empty response if data source is unavailable"],"whenToPreferThis":"Use this endpoint when you need a canonical, up-to-date list of Iranian provinces for form population, data validation, geographic enrichment, or as a reference for province codes used in other IranTools endpoints. It is the authoritative source for Iranian administrative divisions in the IranTools ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:41:43.967Z","isFirstParty":false,"canonicalSlug":"irantools-iran-provinces-list-52d345c3"}