{"uid":"cap_EZZTDq0wOv9jH1AQWj63Q","slug":"irantools-iranian-national-id-validator-77d9334e","name":"IranTools Iranian National ID 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_national_id?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.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0FiCidBOOpt5sa4l73jON","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an Iranian national ID number (code melli) for correctness using the official checksum algorithm","exampleAgentPrompt":"Can you check if the Iranian national ID number 0012345678 is valid?","exampleUseCases":[{"title":"KYC validation for Iranian users","prompt":"I need to verify that the national ID my Iranian customer provided, 0023456789, is a legitimately formatted code melli before processing their registration."},{"title":"Form input validation pipeline","prompt":"Before saving this user's profile, can you validate their Iranian national ID '1234567891' to make sure it passes the official checksum?"},{"title":"Fraud screening on ID field","prompt":"I have a submitted Iranian national ID number '9876543210' that looks suspicious — can you tell me if it's a structurally valid code melli?"}],"resultDescription":"A JSON object indicating whether the provided Iranian national ID (code melli) is valid, likely including a boolean validity flag and potentially details about why it passed or failed the checksum algorithm.","failureModes":["Non-10-digit input returns invalid or error response","Strings with non-numeric characters may fail validation","Empty string input may return an error","Network timeout from Cloudflare Workers edge","Payment failure (402) if USDC balance is insufficient on Base"],"whenToPreferThis":"Use this endpoint when you need to validate Iranian national ID numbers (code melli) on-demand without an API key or subscription — ideal for lightweight KYC checks, form validation, or fraud screening pipelines targeting Iranian users. Prefer this over building your own checksum logic when you want a hosted, pay-per-call solution at $0.005 per validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:42.993Z","isFirstParty":false,"canonicalSlug":"irantools-iranian-national-id-validator-77d9334e"}