# CLDR Plural Category Lookup

> CLDR Plural Category Lookup is a paid API for AI agents from locale-tools.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

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.

## Facts

- Endpoint: GET https://locale-tools.x402tookit.com/plural-category?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cldr-plural-category-lookup-24bd7cf9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_If8fHz34m3aA562Lle_nx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cldr-plural-category-lookup-24bd7cf9
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

CLDR plural category (zero/one/two/few/many/other) of a number in a locale, cardinal and ordinal, with all categories.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
       ]
      },
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cldr-plural-category-lookup-24bd7cf9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from locale-tools.x402tookit.com](https://www.zero.xyz/host/locale-tools.x402tookit.com/llms.txt)