English عربي

Arabic Number to Words API

Convert numbers and financial amounts into words programmatically for invoices, checks, contracts, ERP systems, and accounting tools.

What is Tafqit API?

Tafqit API lets developers and businesses convert numeric amounts into written words — in Arabic and English for the MVP — with currency names, decimal subunits, and document formats (check, invoice, contract, receipt).

Use the free web converter for interactive use, or call the public /api/v1/convert.php endpoint for integrations.

Who is it for?

  • Software developers building invoice or ERP integrations
  • Accounting firms automating cheque and invoice wording
  • Fintech and payment platforms needing amount-in-words on receipts
  • Enterprises localizing financial documents across languages

Use cases

Invoice systems

Auto-fill amount in words on PDF invoices and e-billing.

ERP software

Journal entries and vouchers with correct Arabic wording.

Accounting platforms

Batch validation of figures vs. written amounts.

POS systems

Receipt footers in Arabic and multilingual formats.

Contract automation

Legal clauses with formal amount wording.

Banking / cheque tools

Programmatic check-line generation.

Supported languages

  • Arabic
  • English
  • French
  • Spanish
  • German
  • Italian
  • Portuguese
  • Hindi
  • Urdu
  • Turkish
  • Indonesian
  • Malay

Supported currencies

  • SAR — Saudi Riyal (SAR)
  • AED — UAE Dirham (AED)
  • MAD — Moroccan Dirham (MAD)
  • KWD — Kuwaiti Dinar (KWD)
  • QAR — Qatari Riyal (QAR)
  • OMR — Omani Rial (OMR)
  • BHD — Bahraini Dinar (BHD)
  • USD — US Dollar (USD)
  • EUR — Euro (EUR)
  • INR — Indian Rupee (INR)
  • PKR — Pakistani Rupee (PKR)
  • TRY — Turkish Lira (TRY)
  • IDR — Indonesian Rupiah (IDR)
  • MYR — Malaysian Ringgit (MYR)
Live MVP

GET https://tafqit.org/api/v1/convert.php?amount=1250.75¤cy=SAR&lang=ar&format=check

Example request

GET https://tafqit.org/api/v1/convert.php?amount=1250.75¤cy=SAR&lang=ar&format=check

Example response

{
  "success": true,
  "amount": "1250.75",
  "currency": "SAR",
  "language": "ar",
  "format": "check",
  "result": "فقط ألف ومئتان وخمسون ريال سعودي وخمس وسبعون هللة لا غير",
  "generated_by": "Tafqit.org"
}

This public endpoint is an MVP preview. API keys, higher limits, and paid plans are planned.

API documentation

Endpoint: GET https://tafqit.org/api/v1/convert.php

Discover supported values via /api/v1/meta.php.

Parameters

ParameterRequiredDefaultDescription
amountYes—Numeric amount (0 – 999,999,999.99)
currencyNoSARSAR, USD, EUR, AED, MAD
langNoarar or en
formatNocheckbasic, check, invoice, contract, receipt

Examples

Try the API

Test the live MVP endpoint from your browser. API keys and higher limits are planned.

Request URL:

JSON response

Click “Test API” to fetch a live response.

Result text

This public API endpoint is an MVP preview. API keys, higher limits, and paid plans are planned.

Bulk conversion

Need many rows at once? Use the free bulk converter in your browser today. API bulk endpoints and higher limits are planned for Pro and Business tiers.

Also see Tafqit for Excel for spreadsheet workflows.

Pricing preview

Planned tiers for developers, accountants, and businesses. Payments and login are not available yet.

Free

Web converter, limited API preview, basic formats

Coming soon

Starter

API access · 5,000 requests/month · all languages & currencies

Coming soon

Pro

50,000 requests/month · bulk conversion · CSV/Excel workflows · priority support

Coming soon

Business

Higher limits · ERP integration support · custom use cases

Coming soon

Pricing is planned and may change.

Request API access

Tell us about your project. We will notify you when API access opens.

This opens your email app with a prefilled message — no data is stored on our servers until the API launches.

Prefer email? Write to contact@tafqit.org

FAQ

  • Yes — a public MVP endpoint is live at /api/v1/convert.php. API keys, higher limits, and paid tiers are planned.

  • Convert numeric amounts to words in Arabic and English (MVP), with currency support and document formats (check, invoice, contract, receipt).

  • GET https://tafqit.org/api/v1/convert.php with query parameters: amount, currency, lang, and format.

  • Yes — the web converter stays free. The MVP API is public for testing. Paid tiers with higher limits are planned.

  • Bulk API endpoints are planned. Use the free bulk converter in your browser meanwhile.

  • Use the Request API access form on this page or email us at contact@tafqit.org.

Related tools