# IranTools Iranian Postal Code Validator

> IranTools Iranian Postal Code Validator is a paid API for AI agents from irantools.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Validates an Iranian postal code string and returns structured validation results

## Facts

- Endpoint: POST https://irantools.johnaio281.workers.dev/api/iran/iran_postal_code?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/irantools-iranian-postal-code-validator-891c95a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jdTszJNaHYbHxuZ8_lUUl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability irantools-iranian-postal-code-validator-891c95a6 -d '<json body>'
```

Example prompt: Can you check whether the Iranian postal code 1234567891 is valid?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "value"
 ],
 "properties": {
  "value": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/irantools-iranian-postal-code-validator-891c95a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from irantools.johnaio281.workers.dev](https://www.zero.xyz/host/irantools.johnaio281.workers.dev/llms.txt)