{"uid":"cap_If8fHz34m3aA562Lle_nx","slug":"cldr-plural-category-lookup-24bd7cf9","name":"CLDR Plural Category Lookup","description":"CLDR plural category (zero/one/two/few/many/other) of a number in a locale, cardinal and ordinal, with all categories.","url":"https://locale-tools.x402tookit.com/plural-category?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":["n","locale"],"properties":{"n":{"type":"number","description":"The number, absolute value up to 1e15; fractions allowed (1.5 is 'other' in English)"},"locale":{"type":"string","description":"BCP47 tag such as en, ru, ar, pl or cy (up to 60 characters)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"n":{"type":["null","number"]},"asOf":{"type":["null","string"]},"locale":{"type":["null","string"]},"source":{"type":["null","string"]},"ordinal":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"cardinal":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"icuVersion":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"cldrVersion":{"type":["null","string"]},"resolvedLocale":{"type":["null","string"]},"unicodeVersion":{"type":["null","string"]},"ordinalCategories":{"type":["array","null"],"items":{"type":"string"}},"cardinalCategories":{"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_UlTgLKq6CaWxoMsesVdqo","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":"Returns the CLDR plural category (zero/one/two/few/many/other) for a number in a given locale, for both cardinal and ordinal usage, along with all available categories.","exampleAgentPrompt":"What CLDR plural category does the number 21 fall into for Russian — both cardinal and ordinal — and what are all the plural categories that Russian supports?","exampleUseCases":[{"title":"Pluralizing UI strings for Russian","prompt":"I need to know the cardinal plural category for the number 3 in Russian (locale 'ru') so I can pick the right translation string — 'item', 'items', or 'items' with a different ending."},{"title":"Ordinal suffix selection in English","prompt":"What CLDR ordinal plural category does the number 2 fall into for English? I want to show '2nd' correctly in a ranking list."},{"title":"Arabic pluralization edge case","prompt":"Can you tell me the cardinal plural category for 11 in Arabic and list all the plural categories Arabic has? I'm building a translation system and need to handle all the Arabic plural forms."}],"resultDescription":"Returns the cardinal and ordinal CLDR plural categories (e.g. 'one', 'few', 'many', 'other') for the given number and locale, the full list of all cardinal and ordinal categories that locale supports, the resolved locale, CLDR version, ICU version, Unicode version, and a human-readable summary. Also includes any degraded-mode warnings and reasons for the classification.","failureModes":["Invalid or unrecognized BCP47 locale tag returns an error or falls back to a resolved locale","Number outside supported range (absolute value > 1e15) may return an error","Missing required query parameters (n or locale) returns a validation error","Degraded mode may activate if full CLDR data is unavailable for the locale"],"whenToPreferThis":"Use this endpoint when you need to programmatically select the correct plural form for a number in a specific locale according to CLDR/Unicode standards — especially for languages with complex plural rules like Arabic, Russian, Polish, or Welsh. Prefer this over hardcoded rules or simple one/other logic whenever internationalizing text that varies by count.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:51.184Z","isFirstParty":false,"canonicalSlug":"cldr-plural-category-lookup-24bd7cf9"}