# Farsi Amount to Words Converter

> Farsi Amount to Words Converter is a paid API for AI agents from farsi-tools.johnaio281.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-01).

Converts a numeric monetary amount into its Persian (Farsi) written-out word form, with support for Rial or Toman currency units

## Facts

- Endpoint: GET https://farsi-tools.johnaio281.workers.dev/api/fa/amount-to-words?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farsi-amount-to-words-converter-02b570ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LDl91zpdUuGOIrNa9Wf8G

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 farsi-amount-to-words-converter-02b570ca
```

Example prompt: Can you write out 125000 toman in Persian words for me, the way it would appear on an Iranian cheque?

## When to prefer this

Choose this endpoint when you need to express a monetary amount in Persian words for Iranian documents such as cheques, invoices, receipts, or legal documents that require the Rial or Toman currency denomination spelled out in Farsi script. It is purpose-built for Iranian financial localization and handles the Rial/Toman distinction natively.

## Known failure modes

- Missing required 'amount' query parameter returns an error
- Invalid or non-numeric amount value causes a validation failure
- Unsupported currency unit value (not 'rial' or 'toman') may result in an error or default behavior
- Very large or malformed numbers may produce unexpected results

## How this service works

Persian (Farsi) and Iranian utility API for AI agents. Text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, Iranian national ID / Sheba (IBAN) / mobile / landline / postal code / bank card (Luhn PAN) / company ID / economic code validators, Iranian provinces and cities, official Jalali holidays, Rial-Toman conversion. Also a FIXED-PRICE deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file (not per call) - upload a CSV, TSV or text file and get it back normalized, with an optional Latin transliteration column. Pay per request in USDC on Base via x402 - no signup, no API key, no KYC.

## Output

A JSON object containing a 'words' field with the full Persian (Farsi) text representation of the given amount, including the currency unit name in Persian script (e.g. {"words":"صد و بیست و پنج هزار تومان"})

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "amount"
     ],
     "properties": {
      "unit": {
       "enum": [
        "toman",
        "rial"
       ],
       "type": "string"
      },
      "amount": {
       "type": [
        "number",
        "string"
       ]
      },
      "number": {
       "type": [
        "number",
        "string"
       ]
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "words": "صد و بیست و پنج هزار تومان"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farsi-amount-to-words-converter-02b570ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from farsi-tools.johnaio281.workers.dev](https://www.zero.xyz/host/farsi-tools.johnaio281.workers.dev/llms.txt)