Number and cheque-amount words: English (US, UK, Indian lakh/crore)

$0.005 USDC per call · Business, finance and compliance · POST /api/v1/number-to-words · Id number-to-words

Spells out a number or a money amount in English words for a cheque, contract or invoice, for an agent that must write the amount in words next to the figures. Locales: en-US ("one hundred twenty-three"), en-GB ("one hundred and twenty-three"), en-IN (lakh and crore, "one crore twenty lakh"). With a currency it returns the integer words, the minor-unit fraction as digits over 10^exponent ("56/100", "123/1000" for KWD, none for JPY) and a cheque line using the ISO 4217 currency name; no minor-unit names are generated. Any other locale returns unsupported rather than words that may be wrong. Integer part up to 999,999,999,999,999. Amounts with more fraction digits than the currency allows fail. Does not verify that words and figures on a document agree.

What you get

Words-versus-figures mismatches void cheques and contracts; the words are generated deterministically per locale convention.

Call it

Send the JSON body below to https://agents.writerslogic.com/api/v1/number-to-words. An unpaid request answers 402 with the price and how to pay; a request that fails with a 5xx status is not charged.

curl -i -X POST https://agents.writerslogic.com/api/v1/number-to-words \
  -H 'content-type: application/json' \
  -d '{"items":[{"amount":"1234.56","locale":"en-US","currency":"USD"}]}'

Input

FieldTypeRequiredDescription
itemsarray<object>; max 100 itemsyes

Example request body

{
  "items": [
    {
      "amount": "1234.56",
      "locale": "en-US",
      "currency": "USD"
    }
  ]
}

Result

The response is { "data": ..., "_provenance": ... }. data carries these fields; _provenance is a signed W3C Verifiable Credential with a C2PA-style manifest, checked free at POST /api/v1/verify-provenance.

FieldTypeRequiredDescription
statusstring; one of "pass", "fail", "unknown", "unsupported"nopass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass.
itemsarray<object>no
witnessesarray<object>no
versionsobjectnoEvery semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile).
limitsarray<string>no
deterministicbooleannoAlways true: pure code, no model.

Pay and connect

Available through: x402 (USDC on Base), MCP. MCP clients reach it through the money-math-kit package.

Machine-readable