{"uid":"cap_pXmBk0qnJDLOe4gz--IPG","slug":"irantools-iranian-province-lookup-dfc58f89","name":"IranTools - Iranian Province Lookup","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_province?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},"responseSchema":{"type":"object","additionalProperties":true},"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_FcyNWcq8rxHjuseKK9bW5","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":"Look up information about an Iranian province by name, returning details about that province such as cities, region data, or metadata.","exampleAgentPrompt":"Look up the Iranian province named 'Isfahan' and tell me what you find about it — cities, region, or any details available.","exampleUseCases":[{"title":"Validate province name in a form","prompt":"A user entered 'Khorasane Razavi' as their province — can you look that up in the Iranian province database and tell me if it's a valid province name and what its official details are?"},{"title":"List cities in a specific province","prompt":"I need information about the province of 'Fars' in Iran — look it up and tell me what cities or towns are associated with it."},{"title":"Enrich address data with province info","prompt":"I have a delivery address that mentions the province 'Alborz' in Iran — fetch the province details so I can validate and enrich the address record."}],"resultDescription":"Returns a JSON object containing details about the specified Iranian province, which may include the province's official name, associated cities or regions, and other administrative metadata. The response schema is open-ended (additionalProperties: true), so fields returned may vary.","failureModes":["Province name not found — returns an error or empty result if the name doesn't match a known province","Misspelled or transliterated province name fails to match — Persian vs. Latin spelling variants may cause lookup failures","Ambiguous province name may return unexpected results if multiple matches exist","Network or worker timeout on Cloudflare Workers infrastructure"],"whenToPreferThis":"Use this endpoint when you need structured administrative data about an Iranian province by name, especially for address validation, geospatial enrichment, or building Iran-specific location-aware features. Prefer this over general geocoding APIs when you specifically need Iranian administrative divisions with Persian/Farsi context. It requires no API key and is billed per-call in USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:57.163Z","isFirstParty":false,"canonicalSlug":"irantools-iranian-province-lookup-dfc58f89"}