{"uid":"cap_zbNtU5LbQu8-KSpPX2X7g","slug":"duo-data-utilities-number-to-words-5a680ea4","name":"Duo Data Utilities – Number to Words","description":"Spell a number out in words in English, Dutch, German, French, Spanish, Italian, Portuguese, Polish, Russian, Turkish, Swedish or Japanese, in cardinal, ordinal or currency form. Currency form agrees the number with the currency noun and gives real minor-unit names for 19 currencies (EUR, USD, GBP, CHF, SEK, NOK, DKK, PLN, RUB, TRY, CNY, INR, BRL, MXN, CAD, AUD, NZD, CZK, HUF); any other ISO 4217 code uses a fraction such as 56/100. Values up to 10^15.","url":"https://api.duoleads.com/v1/num/words?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["value"],"properties":{"case":{"enum":["lower","sentence","title"],"type":"string","default":"lower","maxLength":64,"description":"lower (default), sentence or title."},"form":{"enum":["cardinal","ordinal","currency","year"],"type":"string","default":"cardinal","maxLength":64,"description":"cardinal (default), ordinal, currency or year."},"lang":{"enum":["en","nl","de","fr","es","it","pt","pl","ru","tr","sv","ja"],"type":"string","default":"en","maxLength":64,"description":"Language, ISO 639-1. Default en."},"value":{"type":"string","maxLength":32,"description":"Integer or decimal, absolute value below 1e15."},"currency":{"type":"string","maxLength":16,"description":"ISO 4217 code. Required when form=currency, rejected otherwise."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["words","value","lang","form","currency"],"properties":{"form":{"type":"string"},"lang":{"type":"string"},"parts":{"type":["object","null"],"required":["integer_words","minor_words"],"properties":{"minor_words":{"type":["string","null"]},"integer_words":{"type":"string"}}},"value":{"type":"string"},"words":{"type":"string"},"currency":{"type":["object","null"],"required":["code","unit_singular","unit_plural","minor_singular","minor_plural","minor_units"],"properties":{"code":{"type":"string"},"minor_units":{"type":"integer"},"unit_plural":{"type":"string"},"minor_plural":{"type":["string","null"]},"unit_singular":{"type":"string"},"minor_singular":{"type":["string","null"]}}},"rounding_applied":{"type":"boolean"}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/num/words"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"form":"cardinal","lang":"nl","parts":null,"value":"1234","words":"duizend tweehonderdvierendertig","currency":null},"meta":{"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/num/words","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zpuGibk8CDkZ_I8SJSVzr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a number into its written-word form in 12 languages, supporting cardinal, ordinal, currency, and year formats with proper grammatical agreement","exampleAgentPrompt":"Spell out 1,250,000 in French as a cardinal number — I need the lowercase word form for a contract document.","exampleUseCases":[{"title":"Invoice amount in words","prompt":"Write out the number 4875.50 in words in English as a currency amount using USD — I need it for the written line on an invoice."},{"title":"Year spelled out in German","prompt":"How do you say the year 1989 in German? Give me the word form, please."},{"title":"Ordinal number for legal document","prompt":"I need to write 'the twenty-third' in Dutch as an ordinal — can you spell out 23 in Dutch ordinal form?"}],"resultDescription":"A JSON object containing the number spelled out in words (the 'words' field), along with the form used (cardinal/ordinal/currency/year), the language code, the original value, and currency metadata if applicable. Response also includes request ID, computation timestamp, and a price note.","failureModes":["Missing required 'value' parameter returns a validation error","Value at or above 1e15 is out of supported range","Invalid language code (not in supported ISO 639-1 list) returns an error","Ordinal form requested in a language that doesn't support it (e.g. Japanese) returns an error","Currency form requested without providing a valid ISO 4217 currency code","Non-integer or non-decimal string for value returns a parse error"],"whenToPreferThis":"Use this endpoint when you need a deterministic, grammatically correct, multilingual number-to-words conversion — especially for legal documents, invoices, check writing, localized UIs, or any context requiring a spelled-out number. It handles currency grammatical agreement and minor-unit naming (e.g. 'dollars and cents') automatically from the ISO 4217 code, which most generic libraries don't. Prefer this over custom NLP or translation APIs when precision, language breadth (12 languages), and correct currency grammar are all required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:43:21.196Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-number-to-words-5a680ea4"}