{"uid":"cap_jdTszJNaHYbHxuZ8_lUUl","slug":"irantools-iranian-postal-code-validator-891c95a6","name":"IranTools Iranian Postal Code Validator","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_postal_code?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["value"],"properties":{"value":{"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_ACI7dCQvOPyML5PccY5HR","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":"Validates an Iranian postal code string and returns structured validation results","exampleAgentPrompt":"Can you check whether the Iranian postal code 1234567891 is valid?","exampleUseCases":[{"title":"E-commerce address form validation","prompt":"A customer just entered 1987654321 as their Iranian postal code on checkout — can you confirm whether that's a valid Iranian postal code before we let them proceed?"},{"title":"KYC data quality check","prompt":"We're onboarding an Iranian user who listed their postal code as 3417893456 — please validate it to make sure it's a legitimate Iranian postal code."},{"title":"Bulk address cleansing for CRM","prompt":"I have a contact record with an Iranian postal code of 9181765431 — can you verify it's properly formatted and valid?"}],"resultDescription":"A JSON object indicating whether the provided postal code is valid according to Iranian postal code rules, potentially including details such as validity flag, error messages, and region or province information associated with the code.","failureModes":["Missing or empty value field returns a validation error","Non-string or malformed input may cause a 400 error","A syntactically wrong postal code returns invalid with reasons","Payment failure via x402 returns 402 status before processing"],"whenToPreferThis":"Use this endpoint when you need to validate Iranian (10-digit) postal codes specifically, especially in address forms, KYC pipelines, or data quality workflows targeting Iran. Prefer this over generic address validators that lack Iranian-specific rules.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:41:47.033Z","isFirstParty":false,"canonicalSlug":"irantools-iranian-postal-code-validator-891c95a6"}