{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"number-to-words"},"result":{"entity_type":"calculator","id":"number-to-words","calculator_id":"number-to-words","canonical_url":"https://tttkmbb.com/math/number-to-words","name":"Number to Words Converter","title":"Number to Words Converter – Cardinal, Ordinal and Cheque-Style English Words (Short Scale)","category":"math","category_name":"Math","tool_name":"convert_number_to_words","featured_mcp_tool":false,"description":"Spells out a number in English words using the short scale (thousand, million, billion, trillion), gives the ordinal form for whole numbers, and, for amounts of money, the spoken and cheque-writing forms with dollars and cents.","use_when":"You need a number written in words for a cheque, contract, invoice or text, or the ordinal form (e.g. 'twenty-first') of an integer.","do_not_use_when":"You need Roman numerals (use roman-numeral), a different language, or the long scale (milliard/billion) used in some European languages.","inputs":[{"name":"number","label":"Number","type":"number","required":true,"min":-1000000000000000,"max":1000000000000000,"description":"The number to spell out, up to ±10^15 (one quadrillion); decimals are read digit by digit, or as cents when currency is true.","example":1234.56},{"name":"currency","label":"As currency","type":"boolean","required":false,"default":false,"description":"true to also return the amount as dollars and cents (spoken and cheque style).","example":true}],"outputs":[{"name":"words","label":"In words","type":"string","decimals":4,"description":"Cardinal words, e.g. 'one thousand two hundred thirty-four point five six'; negatives start with 'minus'."},{"name":"ordinal","label":"Ordinal","type":"string","decimals":4,"description":"Ordinal words such as 'one thousand two hundred thirty-fourth' (whole numbers only)."},{"name":"currency_words","label":"Currency (spoken)","type":"string","decimals":4,"description":"e.g. 'one thousand two hundred thirty-four dollars and fifty-six cents' (only when currency is true)."},{"name":"cheque_words","label":"Cheque style","type":"string","decimals":4,"description":"e.g. 'One thousand two hundred thirty-four and 56/100 dollars' (only when currency is true)."},{"name":"integer_part","label":"Integer part","type":"string","decimals":4,"description":"The digits before the decimal point."},{"name":"scale","label":"Largest scale word","type":"string","decimals":4,"description":"The highest scale needed: 'units', 'thousand', 'million', 'billion', 'trillion' or 'quadrillion'."}],"input_schema":{"type":"object","properties":{"number":{"description":"The number to spell out, up to ±10^15 (one quadrillion); decimals are read digit by digit, or as cents when currency is true.","type":"number","minimum":-1000000000000000,"maximum":1000000000000000,"examples":[1234.56]},"currency":{"description":"true to also return the amount as dollars and cents (spoken and cheque style).","type":"boolean","default":false,"examples":[true]}},"additionalProperties":false,"required":["number"]},"output_schema":{"type":"object","properties":{"words":{"description":"Cardinal words, e.g. 'one thousand two hundred thirty-four point five six'; negatives start with 'minus'.","type":"string"},"ordinal":{"description":"Ordinal words such as 'one thousand two hundred thirty-fourth' (whole numbers only).","type":"string"},"currency_words":{"description":"e.g. 'one thousand two hundred thirty-four dollars and fifty-six cents' (only when currency is true).","type":"string"},"cheque_words":{"description":"e.g. 'One thousand two hundred thirty-four and 56/100 dollars' (only when currency is true).","type":"string"},"integer_part":{"description":"The digits before the decimal point.","type":"string"},"scale":{"description":"The highest scale needed: 'units', 'thousand', 'million', 'billion', 'trillion' or 'quadrillion'.","type":"string"}}},"formula":"Digits are grouped in threes from the right; each non-zero group is read as hundreds/tens/units followed by its short-scale name (10^3 thousand, 10^6 million, 10^9 billion, 10^12 trillion, 10^15 quadrillion); cents = round(fraction × 100)","method":"American English conventions: no 'and' between hundreds and tens ('one hundred five'), hyphens in twenty-one to ninety-nine; the fractional part is read digit by digit after 'point'. Cheque style follows the common US form 'Amount and cc/100 dollars'.","sources":[{"name":"Wikipedia – English numerals","url":"https://en.wikipedia.org/wiki/English_numerals","type":"reference","retrieved_at":"2026-09-24"},{"name":"Wikipedia – Long and short scales","url":"https://en.wikipedia.org/wiki/Long_and_short_scales","type":"reference","retrieved_at":"2026-09-24"},{"name":"Wikipedia – Names of large numbers","url":"https://en.wikipedia.org/wiki/Names_of_large_numbers","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"1234.56 as currency","inputs":{"number":1234.56,"currency":true},"expected":{"words":"one thousand two hundred thirty-four point five six","currency_words":"one thousand two hundred thirty-four dollars and fifty-six cents","cheque_words":"One thousand two hundred thirty-four and 56/100 dollars","integer_part":"1234","scale":"thousand"},"url":"https://tttkmbb.com/api/v1/calculate/number-to-words?number=1234.56&currency=true"},{"name":"123456789","inputs":{"number":123456789},"expected":{"words":"one hundred twenty-three million four hundred fifty-six thousand seven hundred eighty-nine","ordinal":"one hundred twenty-three million four hundred fifty-six thousand seven hundred eighty-ninth","integer_part":"123456789","scale":"million"},"url":"https://tttkmbb.com/api/v1/calculate/number-to-words?number=123456789"}],"faq":[{"q":"Is 'and' inserted, as in British English?","a":"No. The output follows American usage ('two hundred five'); add 'and' after 'hundred' yourself for British style ('two hundred and five')."},{"q":"How are cents rounded?","a":"The fractional part is rounded to the nearest cent (half up), so 1234.565 becomes 1234.57; 100 cents carry into the dollar amount."},{"q":"Which scale is used for billion?","a":"The short scale: billion = 10^9, trillion = 10^12, quadrillion = 10^15, as in modern English usage worldwide."}],"tags":["number to words","spell out number","cheque amount in words","check writing","ordinal numbers","number names"],"related":[{"calculator_id":"roman-numeral","reason":"Another way of writing integers."},{"calculator_id":"rounding","reason":"Round a value before spelling it out."},{"calculator_id":"base-converter","reason":"Digits of a number in other bases."}],"links":{"html":"https://tttkmbb.com/math/number-to-words","markdown":"https://tttkmbb.com/math/number-to-words.md","json":"https://tttkmbb.com/math/number-to-words.json","api":"https://tttkmbb.com/api/v1/calculate/number-to-words","schema":"https://tttkmbb.com/api/v1/calculators/number-to-words","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T01:46:01Z"}