# IranTools Iranian SHEBA Validation

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

Validates an Iranian SHEBA (bank account) number and returns structured information about its validity and parsed components

## Facts

- Endpoint: POST https://irantools.johnaio281.workers.dev/api/iran/iran_sheba?utm_source=zero.xyz
- Price: $0.005/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-sheba-validation-86b88778
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cMal1LWLVKkjXEWHR5ToL

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-sheba-validation-86b88778 -d '<json body>'
```

Example prompt: Can you check whether this Iranian SHEBA number is valid: IR820540102680020817909002?

## When to prefer this

Use this endpoint when you need to validate Iranian SHEBA numbers (IR-prefixed bank account identifiers) specifically, as part of fintech workflows, payment processing, supplier onboarding, or data quality checks involving Iranian bank accounts. Prefer this over generic IBAN validators when you need Iran-specific bank code parsing or are already using the IranTools suite for other Iranian data validation tasks.

## Known failure modes

- Invalid or malformed SHEBA string returns a validation failure response
- Missing 'value' field in request body returns a 400-level error
- Non-Iranian IBAN format (missing IR prefix or wrong length) may return invalid status
- Payment failure on the x402 layer results in 402 response before validation occurs

## 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 SHEBA number is valid, along with parsed components such as bank code, check digit status, and potentially the bank name 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-sheba-validation-86b88778/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)