{"uid":"cap_2ti_hT3AM1q7EYZKt4tzs","slug":"number-words-year-in-english-words-61d60678","name":"Number Words – Year in English Words","description":"How to say a year in English: the usual pair reading (nineteen eighty-four, twenty oh-five) and the full cardinal.","url":"https://number-words.x402tookit.com/year-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":["year"],"properties":{"year":{"type":"string","description":"A year from 1 to 9999"},"variant":{"enum":["us","uk"],"type":"string","description":"us (default) or uk for the full cardinal ('and' in the UK)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"full":{"type":["null","string"]},"pair":{"type":["null","string"]},"year":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"variant":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"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_mUCQgFkEQ9GgAKHIaCV_C","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 year (1–9999) into its spoken English form, returning both the pair reading (e.g. 'nineteen eighty-four') and the full cardinal form.","exampleAgentPrompt":"How do you say the year 1984 in English — give me both the usual pair reading like 'nineteen eighty-four' and the full cardinal form, using the UK style with 'and'.","exampleUseCases":[{"title":"Voiceover script year pronunciation","prompt":"I'm writing a voiceover script and need to know how to say the year 2005 in English — give me the pair reading like 'twenty oh-five' and the full cardinal form please."},{"title":"UK-style historical document narration","prompt":"What's the British English way to say the year 1815? I need both the conversational pair form and the full cardinal with 'and' for a narration."},{"title":"Accessibility text-to-speech year formatting","prompt":"I need the spoken English words for the year 1066 — both the short pair reading and the full cardinal — so I can format it correctly for a text-to-speech system."}],"resultDescription":"Returns a JSON object with the numeric year, the pair reading (e.g. 'nineteen eighty-four'), the full cardinal form (e.g. 'one thousand nine hundred and eighty-four'), the variant used (us/uk), a source attribution, a summary, and optionally degraded status and disclaimer fields.","failureModes":["Missing required 'year' query parameter returns an error","Year outside valid range 1–9999 returns an error or null fields","Invalid variant value (not 'us' or 'uk') may fall back to default or error","Network/payment failure returns no response"],"whenToPreferThis":"Use this endpoint when you specifically need a year rendered as spoken English words in either the colloquial pair form ('nineteen eighty-four') or as a full cardinal, with US/UK style variants. Prefer this over a general number-to-words endpoint when year-specific pronunciation conventions matter, since general cardinal converters do not produce the culturally standard pair-reading form used for years.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:24.889Z","isFirstParty":false,"canonicalSlug":"number-words-year-in-english-words-61d60678"}