{"openapi":"3.1.0","info":{"title":"Number Words","version":"1.0.0","description":"Numbers to words and back: English, Spanish, French, German, Roman numerals, cheque amounts, years and ordinals. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Number Words: Numbers to words and back: English, Spanish, French, German, Roman numerals, cheque amounts, years and ordinals. Use /english-words for English cardinals and ordinals (US or UK), /english-parse to turn English number words into digits, /spanish-words /french-words /german-words for those languages, /roman-numeral for Roman numerals both ways, /cheque-words for currency amount wording, /ordinal-format for 1st, 1er, 1.o and 1. suffixes, /year-words for how to say a year. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://number-words.x402tookit.com"}],"paths":{"/cheque-words":{"get":{"operationId":"cheque_words","summary":"Write a money amount in words for a cheque (EN/ES/FR/DE): you give the currency names, no rates; words or 56/100 cents.","description":"Write a money amount in words for a cheque (EN/ES/FR/DE): you give the currency names, no rates; words or 56/100 cents.","tags":["numbers","words","cheque","currency","amount"],"parameters":[{"name":"amount","in":"query","required":true,"description":"Amount such as 1234.56 (up to 12 integer digits; decimals up to minorDigits)","schema":{"type":"string"}},{"name":"majorName","in":"query","required":true,"description":"Main unit, singular, in the chosen language, for example dollar, euro, libra, Pfund","schema":{"type":"string"}},{"name":"majorPlural","in":"query","required":false,"description":"Main unit plural; if omitted a regular plural is made (dollars, euros) - give it for irregular names","schema":{"type":"string"}},{"name":"minorName","in":"query","required":false,"description":"Sub-unit singular, for example cent, centavo, centime, Cent. Omit for currencies without one","schema":{"type":"string"}},{"name":"minorPlural","in":"query","required":false,"description":"Sub-unit plural; regular plural if omitted (pence needs this)","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"en (default), es, fr or de","schema":{"type":"string","enum":["en","es","fr","de"]}},{"name":"style","in":"query","required":false,"description":"words (default: and fifty-six cents) or fraction (and 56/100)","schema":{"type":"string","enum":["words","fraction"]}},{"name":"variant","in":"query","required":false,"description":"English only: us (default) or uk (one hundred and five)","schema":{"type":"string","enum":["us","uk"]}},{"name":"minorDigits","in":"query","required":false,"description":"Decimal places of the currency, 0 to 3 (default 2; JPY 0, KWD 3)","schema":{"type":"integer"}},{"name":"majorGender","in":"query","required":false,"description":"Spanish: gender of the main unit name, masculine (default) or feminine (libra)","schema":{"type":"string","enum":["masculine","feminine"]}},{"name":"minorGender","in":"query","required":false,"description":"Spanish: gender of the sub-unit name, masculine (default) or feminine","schema":{"type":"string","enum":["masculine","feminine"]}},{"name":"currencyCode","in":"query","required":false,"description":"Optional ISO code to echo back, for example USD (not used for any rate)","schema":{"type":"string"}},{"name":"letterCase","in":"query","required":false,"description":"sentence (default), title, upper or lower","schema":{"type":"string","enum":["sentence","title","upper","lower"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"words":{"type":["null","string"]},"amount":{"type":["null","string"]},"major":{"type":["null","number"]},"minor":{"type":["null","number"]},"minorDigits":{"type":["null","number"]},"language":{"type":["null","string"]},"currencyCode":{"type":["null","string"]},"variant":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"One thousand two hundred thirty-four dollars and fifty-six cents","reasons":["Both parts written in words."],"words":"One thousand two hundred thirty-four dollars and fifty-six cents","amount":"1234.56","major":1234,"minor":56,"minorDigits":2,"language":"en","currencyCode":"USD","variant":"us","degraded":false,"notChecked":["exchange rates and whether the currency code matches the names: both are caller inputs","plural forms of irregular currency names unless you supply them (pence, yenes)","…3 more"],"source":"computed locally (number spelling rules per language; currency names supplied by the caller)","asOf":"2026-10-12T00:58:47.197Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/cheque-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/cheque-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/cheque-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/cheque-words"}}]}}},"/english-parse":{"get":{"operationId":"english_parse","summary":"Parse English number words (one thousand and five, twenty-first, minus three point five) into digits.","description":"Parse English number words (one thousand and five, twenty-first, minus three point five) into digits.","tags":["numbers","words","english","parse","text-to-number"],"parameters":[{"name":"text","in":"query","required":true,"description":"Number words, up to 2000 characters; hyphens, commas and 'and' are accepted","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"value":{"type":["null","string"]},"ordinal":{"type":["boolean","null"]},"normalized":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"PARSED","summary":"two thousand three hundred and forty-five = 2345.","reasons":["'and' is accepted after hundred or a scale word; scale words must descend (million before thousand); 'a hundred' and 'a thousand' mean one."],"input":"two thousand three hundred and forty-five","value":"2345","ordinal":false,"normalized":"two thousand three hundred forty-five","degraded":false,"notChecked":["digits already written as numerals (use them directly)","informal forms: dozen, score, couple, 'a grand', 'nineteen eighty-four' year-reading","…3 more"],"source":"computed locally (grammar of standard English number words)","asOf":"2026-10-12T00:58:47.461Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-parse"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-parse"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-parse"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-parse"}}]}}},"/english-words":{"get":{"operationId":"english_words","summary":"A number as English words: cardinal and ordinal, US or UK 'and' style, hyphenation, decimals, up to 36 digits.","description":"A number as English words: cardinal and ordinal, US or UK 'and' style, hyphenation, decimals, up to 36 digits.","tags":["numbers","words","english","ordinal","spelling"],"parameters":[{"name":"value","in":"query","required":true,"description":"The number, for example 1234, -12.5 or 1,000,000 (up to 36 digits, up to 20 decimals)","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"us (default: one hundred five) or uk (one hundred and five, one thousand and five)","schema":{"type":"string","enum":["us","uk"]}},{"name":"hyphenate","in":"query","required":false,"description":"true (default) writes twenty-one; false writes twenty one","schema":{"type":"boolean"}},{"name":"negative","in":"query","required":false,"description":"minus (default) or negative","schema":{"type":"string","enum":["minus","negative"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"value":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"ordinal":{"type":["null","string"]},"numericOrdinal":{"type":["null","string"]},"style":{"type":["null","string"]},"digits":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"one thousand two hundred thirty-four","reasons":["US style: no 'and' inside the number."],"value":"1234","cardinal":"one thousand two hundred thirty-four","ordinal":"one thousand two hundred thirty-fourth","numericOrdinal":"1234th","style":"us","digits":4,"degraded":false,"notChecked":["long-scale names (milliard, billiard) are not used: a billion here is 10^9 in both styles","UK style puts 'and' after hundred and before a final group under 100; house styles that add commas or drop 'and' differ","…2 more"],"source":"computed locally (standard English number spelling, short scale)","asOf":"2026-10-12T00:58:47.724Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/english-words"}}]}}},"/french-words":{"get":{"operationId":"french_words","summary":"A whole number as French words: cardinal and ordinal, France/Belgium/Swiss forms (septante), 1990 hyphen spelling.","description":"A whole number as French words: cardinal and ordinal, France/Belgium/Swiss forms (septante), 1990 hyphen spelling.","tags":["numbers","words","french","francais","ordinal"],"parameters":[{"name":"value","in":"query","required":true,"description":"Whole number up to 999,999,999,999,999 (15 digits); negatives get 'moins'","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"france (default: soixante-dix, quatre-vingts), belgium (septante, nonante) or switzerland (septante, huitante, nonante)","schema":{"type":"string","enum":["france","belgium","switzerland"]}},{"name":"spelling","in":"query","required":false,"description":"traditional (default: vingt et un, deux cents) or rectified (1990: vingt-et-un, deux-cents)","schema":{"type":"string","enum":["traditional","rectified"]}},{"name":"gender","in":"query","required":false,"description":"masculine (default) or feminine; only changes the ordinal 1 (premier, première)","schema":{"type":"string","enum":["masculine","feminine"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"value":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"ordinal":{"type":["null","string"]},"ordinalFigure":{"type":["null","string"]},"region":{"type":["null","string"]},"spelling":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"quatre-vingts","reasons":["vingt and cent take -s only when multiplied and not followed by another number (quatre-vingts, deux cents; quatre-vingt-un, deux cent un, deux cent mille). Million, milliard and billion are nouns and …"],"value":"80","cardinal":"quatre-vingts","ordinal":"quatre-vingtième","ordinalFigure":"80e","region":"france","spelling":"traditional","degraded":false,"notChecked":["the Swiss huitante is used in Vaud, Valais and Fribourg only; Geneva, Neuchâtel and Jura say quatre-vingts (choose belgium for septante + quatre-vingts + nonante)","numbers of 16 digits or more","…3 more"],"source":"computed locally (Academie francaise rules; 1990 spelling rectification; Belgian and Swiss numerals)","asOf":"2026-10-12T00:58:47.988Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/french-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/french-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/french-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/french-words"}}]}}},"/german-words":{"get":{"operationId":"german_words","summary":"A whole number as German words (one-word below a million), ordinals with case endings, ein/eins, ß or ss.","description":"A whole number as German words (one-word below a million), ordinals with case endings, ein/eins, ß or ss.","tags":["numbers","words","german","deutsch","ordinal"],"parameters":[{"name":"value","in":"query","required":true,"description":"Whole number up to 999,999,999,999,999 (15 digits); negatives get 'minus'","schema":{"type":"string"}},{"name":"omitEin","in":"query","required":false,"description":"true writes hundert/tausend; false (default) writes einhundert/eintausend","schema":{"type":"boolean"}},{"name":"attributive","in":"query","required":false,"description":"true gives ein (ein Euro) at the end; false (default) gives eins","schema":{"type":"boolean"}},{"name":"eszett","in":"query","required":false,"description":"true (default) writes dreißig; false writes dreissig (Swiss)","schema":{"type":"boolean"}},{"name":"ending","in":"query","required":false,"description":"Ordinal case ending: e (default, die erste), er, es, en or em","schema":{"type":"string","enum":["e","er","es","en","em"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"value":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"ordinal":{},"ordinalFigure":{"type":["null","string"]},"ordinalEnding":{"type":["null","string"]},"omitEin":{"type":["boolean","null"]},"eszett":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"eine Million zweihundertvierunddreißigtausendfünfhundertsiebenundsechzig","reasons":["Numbers below one million are written as one word, units before tens joined by 'und' (einundzwanzig). Million, Milliarde and Billion are separate nouns with 'eine' for one (eine Million). One at the v…"],"value":"1234567","cardinal":"eine Million zweihundertvierunddreißigtausendfünfhundertsiebenundsechzig","ordinal":null,"ordinalFigure":"1234567.","ordinalEnding":"e","omitEin":false,"eszett":true,"degraded":false,"notChecked":["colloquial hundred-forms (elfhundert for 1100)","ordinals at one million and above are not given","…3 more"],"source":"computed locally (Duden rules for numerals)","asOf":"2026-10-12T00:58:48.251Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/german-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/german-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/german-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/german-words"}}]}}},"/ordinal-format":{"get":{"operationId":"ordinal_format","summary":"Ordinal suffix and word for a number: 1st/2nd/3rd/11th, French 1er/2e, Spanish 1.º/1.ª, German 1. with the word form.","description":"Ordinal suffix and word for a number: 1st/2nd/3rd/11th, French 1er/2e, Spanish 1.º/1.ª, German 1. with the word form.","tags":["numbers","ordinal","suffix","formatting","languages"],"parameters":[{"name":"value","in":"query","required":true,"description":"Whole number 0 up to 999,999,999,999,999","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"en (default), es, fr or de","schema":{"type":"string","enum":["en","es","fr","de"]}},{"name":"gender","in":"query","required":false,"description":"masculine (default) or feminine, for Spanish and French","schema":{"type":"string","enum":["masculine","feminine"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"value":{"type":["null","string"]},"language":{"type":["null","string"]},"figure":{"type":["null","string"]},"word":{"type":["null","string"]},"alternatives":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"112 as an ordinal in en: 112th (one hundred twelfth).","reasons":["English: th, except st after 1, nd after 2, rd after 3 - and always th for the teens 11, 12, 13 (also 111, 112, 113)."],"value":"112","language":"en","figure":"112th","word":"one hundred twelfth","alternatives":[],"degraded":false,"notChecked":["Spanish words are given for 1 to 100 only; German words for 0 to 999,999","typographic variants such as superscript th, or 1ère and 1.er, are listed as alternatives only where they exist","…1 more"],"source":"computed locally (English suffix rule; RAE; Academie francaise; Duden)","asOf":"2026-10-12T00:58:48.514Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/ordinal-format"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/ordinal-format"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/ordinal-format"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/ordinal-format"}}]}}},"/roman-numeral":{"get":{"operationId":"roman_numeral","summary":"Convert 1-3999 to Roman numerals or read Roman numerals as numbers, strict or lenient (IIII, IC), additive style option.","description":"Convert 1-3999 to Roman numerals or read Roman numerals as numbers, strict or lenient (IIII, IC), additive style option.","tags":["numbers","roman","numerals","convert","parse"],"parameters":[{"name":"value","in":"query","required":true,"description":"Digits 1 to 3999 (becomes Roman) or Roman letters such as MCMXCIV (becomes a number)","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"Reading Roman: strict (default; only standard forms) or lenient (also IIII, VIIII, IC, XM)","schema":{"type":"string","enum":["strict","lenient"]}},{"name":"style","in":"query","required":false,"description":"Writing Roman: standard (default, IV IX XL XC CD CM) or additive (IIII, VIIII, XXXX)","schema":{"type":"string","enum":["standard","additive"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"direction":{"type":["null","string"]},"roman":{"type":["null","string"]},"number":{"type":["null","number"]},"style":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"1994 = MCMXCIV.","reasons":["Standard subtractive style: IV IX XL XC CD CM."],"input":"1994","direction":"to-roman","roman":"MCMXCIV","number":1994,"style":"standard","degraded":false,"notChecked":["numbers above 3999 (the vinculum overline is not supported) and zero (Romans had no numeral; N is not accepted)","the medieval or clock-face variants beyond IIII, VIIII and similar additive forms","…1 more"],"source":"computed locally (standard Roman numeral rules)","asOf":"2026-10-12T00:58:48.777Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/roman-numeral"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/roman-numeral"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/roman-numeral"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/roman-numeral"}}]}}},"/spanish-words":{"get":{"operationId":"spanish_words","summary":"A whole number as Spanish words (cardinal, ordinal 1-100), gender, un/uno apocope, long scale (mil millones, un billón).","description":"A whole number as Spanish words (cardinal, ordinal 1-100), gender, un/uno apocope, long scale (mil millones, un billón).","tags":["numbers","words","spanish","espanol","ordinal"],"parameters":[{"name":"value","in":"query","required":true,"description":"Whole number up to 999,999,999,999,999 (15 digits); negatives get 'menos'","schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"description":"masculine (default) or feminine: una, veintiuna, doscientas","schema":{"type":"string","enum":["masculine","feminine"]}},{"name":"beforeNoun","in":"query","required":false,"description":"true gives un/veintiún (or una) as before a noun; false (default) gives uno/veintiuno","schema":{"type":"boolean"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"value":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"ordinal":{},"ordinalFigure":{"type":["null","string"]},"gender":{"type":["null","string"]},"beforeNoun":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"veintiún mil trescientos cuarenta y cinco","reasons":["Long scale: mil millones is 10^9 and un billón is 10^12 (not 10^9 as in US English). Before mil the numbers are apocopated (veintiún mil).","Ordinals are provided for 1 to 100 only."],"value":"21345","cardinal":"veintiún mil trescientos cuarenta y cinco","ordinal":null,"ordinalFigure":"21345.º","gender":"masculine","beforeNoun":false,"degraded":false,"notChecked":["numbers of 16 digits or more","decimals and fractions","…3 more"],"source":"computed locally (RAE spelling of numerals; long scale: mil millones = 10^9, billón = 10^12)","asOf":"2026-10-12T00:58:49.043Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/spanish-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/spanish-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/spanish-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/spanish-words"}}]}}},"/year-words":{"get":{"operationId":"year_words","summary":"How to say a year in English: the usual pair reading (nineteen eighty-four, twenty oh-five) and the full cardinal.","description":"How to say a year in English: the usual pair reading (nineteen eighty-four, twenty oh-five) and the full cardinal.","tags":["numbers","words","year","english","spoken"],"parameters":[{"name":"year","in":"query","required":true,"description":"A year from 1 to 9999","schema":{"type":"string"}},{"name":"variant","in":"query","required":false,"description":"us (default) or uk for the full cardinal ('and' in the UK)","schema":{"type":"string","enum":["us","uk"]}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"year":{"type":["null","number"]},"pair":{"type":["null","string"]},"full":{"type":["null","string"]},"variant":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"1984 is usually read \"nineteen eighty-four\"; in full \"one thousand nine hundred eighty-four\".","reasons":["Pair reading: split into two numbers (19 84). A zero tens digit becomes 'oh' (19 05 is nineteen oh-five), x00 is 'hundred' (nineteen hundred), x000 is 'thousand', and 2000 to 2009 uses 'two thousand'."],"year":1984,"pair":"nineteen eighty-four","full":"one thousand nine hundred eighty-four","variant":"us","degraded":false,"notChecked":["BC/BCE dating and calendar systems","regional habits: 2000-2009 is read 'two thousand five' here; 'twenty oh-five' is also heard","…2 more"],"source":"computed locally (common English conventions for reading years)","asOf":"2026-10-12T00:58:49.306Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/year-words"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/year-words"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/year-words"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://number-words.x402tookit.com/year-words"}}]}}}}}