India API

Docs › Money and business

Number to words API

Numbers and rupee amounts in words, the Indian way.

Spells numbers with lakh and crore in English, Hindi or Tamil. 1,00,000 is "one lakh". Use style=currency for cheque-style amounts.

Base URL https://api.dharun.devNo API key600 requests a minuteThis page as Markdown

Spell out a number

GET/v1/words/{number}

ParameterDescription
numberpath, requiredThe number. Commas, spaces and underscores are ignored.
langqueryLanguage. Default en. One of: en, hi, ta.
stylequerycurrency gives rupees and paise. Default number. One of: number, currency.

curl

curl "https://api.dharun.dev/v1/words/1,25,000.50?style=currency"

JavaScript

const response = await fetch("https://api.dharun.dev/v1/words/1,25,000.50?style=currency");
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
console.log(body.data);

Python

import requests

response = requests.get("https://api.dharun.dev/v1/words/1,25,000.50?style=currency", timeout=10)
body = response.json()
if not response.ok:
    raise RuntimeError(body["error"]["message"])
print(body["data"])

Response

{
  "data": {
    "input": "1,25,000.50",
    "number": "125000.50",
    "language": "en",
    "style": "currency",
    "words": "one lakh twenty-five thousand rupees and fifty paise only"
  },
  "meta": {}
}

Guides

Write rupee amounts in words for invoices and cheques

Using an AI assistant? Connect the MCP server and it can call this API by itself.