# IranTools Iranian Economic Code Validator

> IranTools Iranian Economic 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 economic code (kode eqtesadi) to confirm it is correctly formatted and authentic

## Facts

- Endpoint: POST https://irantools.johnaio281.workers.dev/api/iran/iran_economic_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-economic-code-validator-65d7d6aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NPBxt2Y49igOEh3b8wTwM

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-economic-code-validator-65d7d6aa -d '<json body>'
```

Example prompt: Can you check whether this Iranian economic code is valid: 411334305

## When to prefer this

Use this endpoint when you need to programmatically verify the authenticity and format of an Iranian economic code (kode eqtesadi), especially for KYC, business onboarding, e-commerce seller verification, or compliance workflows involving Iranian entities. Prefer this over manual lookup or generic regex checks because it applies the official algorithmic validation rules specific to Iranian economic codes.

## Known failure modes

- Invalid or malformed economic code returns a validation failure with reason
- Non-numeric or wrong-length input may return a format error
- Network or payment failure (HTTP 402 if USDC payment not attached) prevents the call from completing
- Empty string input returns a missing value error

## 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

Returns a JSON object indicating whether the submitted Iranian economic code is valid, along with any parsed details or error reasons if invalid.

## 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-economic-code-validator-65d7d6aa/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)