{"uid":"cap_r53Ld2e5BUM3lf1scwVsJ","slug":"number-words-french-cardinal-ordinal-converter-23642472","name":"Number Words: French Cardinal & Ordinal Converter","description":"A whole number as French words: cardinal and ordinal, France/Belgium/Swiss forms (septante), 1990 hyphen spelling.","url":"https://number-words.x402tookit.com/french-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":{"value":{"type":"string","description":"Whole number up to 999,999,999,999,999 (15 digits); negatives get 'moins'"},"gender":{"enum":["masculine","feminine"],"type":"string","description":"masculine (default) or feminine; only changes the ordinal 1 (premier, première)"},"region":{"enum":["france","belgium","switzerland"],"type":"string","description":"france (default: soixante-dix, quatre-vingts), belgium (septante, nonante) or switzerland (septante, huitante, nonante)"},"spelling":{"enum":["traditional","rectified"],"type":"string","description":"traditional (default: vingt et un, deux cents) or rectified (1990: vingt-et-un, deux-cents)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"value":{"type":["null","string"]},"region":{"type":["null","string"]},"source":{"type":["null","string"]},"ordinal":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"spelling":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"ordinalFigure":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_57w4TKk7dYnr4wzQZj7El","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a whole number into French words (cardinal and ordinal), supporting France, Belgium, and Swiss regional variants and 1990 spelling reform.","exampleAgentPrompt":"How do you write 80 in French words? Give me both the cardinal and ordinal forms using the Swiss regional variant (septante/huitante/nonante) and the 1990 rectified spelling, masculine gender.","exampleUseCases":[{"title":"Legal document number spelling","prompt":"I'm drafting a legal contract in French and need to write out the number 250000 in full French words — cardinal and ordinal — using standard France spelling (soixante-dix style) and masculine gender. Can you give me both forms?"},{"title":"Belgian French educational worksheet","prompt":"For a Belgian French worksheet, can you spell out the numbers 70, 80, and 90 in words using the Belgium regional variant (septante, huitante, nonante)? I need the cardinal forms, masculine."},{"title":"Swiss French cheque writing","prompt":"I need to write 1421 in French words for a Swiss cheque — please use the Switzerland regional variant and the traditional spelling, feminine gender for the ordinal."}],"resultDescription":"Returns the cardinal French word form (e.g. 'quatre-vingt'), ordinal word form (e.g. 'quatre-vingtième'), ordinal figure (e.g. '80e'), plus metadata: region used, spelling convention applied, and the original value.","failureModes":["Number exceeds 15 digits — API returns an error or null value","Non-integer or non-numeric input string — validation failure","Invalid enum value for region or spelling — request rejected","Negative numbers handled with 'moins' prefix but edge cases may fail","Missing required 'value' query parameter — returns error response"],"whenToPreferThis":"Choose this endpoint when you need authoritative French number-to-words conversion with regional awareness (France vs Belgium vs Switzerland variants like septante/huitante/nonante) and support for both traditional and 1990 rectified spelling reform. Prefer over generic translation APIs when accuracy of French linguistic conventions (gender agreement in ordinals, regional dialect differences) is critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:33:23.450Z","isFirstParty":false,"canonicalSlug":"number-words-french-cardinal-ordinal-converter-23642472"}