# Number Words – English Cardinal & Ordinal

> Number Words – English Cardinal & Ordinal is a paid API for AI agents from number-words.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Converts a numeric value into English words, returning both cardinal (one hundred five) and ordinal (one hundred fifth) forms, with options for US/UK style, hyphenation, and negative prefix.

## Facts

- Endpoint: GET https://number-words.x402tookit.com/english-words?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/number-words-english-cardinal-ordinal-4438b8a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d2-Xwpcdkxj3QsMsaU20M

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 number-words-english-cardinal-ordinal-4438b8a0
```

Example prompt: Spell out the number 1,042,007 in English words — give me both the cardinal and ordinal forms, UK style with 'and', and hyphenate the compound parts.

## When to prefer this

Choose this endpoint when you need precise English-language word representations of numbers — cardinal and ordinal — with control over US vs UK style, hyphenation, and negative prefix. It supports very large integers (up to 36 digits) and decimals (up to 20 decimal places), making it suitable for legal documents, accessibility text, financial writing, and localized content. Prefer it over generic LLM text generation when deterministic, rule-correct spelling of numbers is required.

## Known failure modes

- Missing required 'value' query parameter returns an error
- Value exceeding 36 digits or 20 decimal places may be rejected or degraded
- Non-numeric input string returns a validation error
- Invalid enum value for 'style' or 'negative' returns a bad request error
- Network or payment authorization failure returns a 402 or 5xx error

## How this service works

A number as English words: cardinal and ordinal, US or UK 'and' style, hyphenation, decimals, up to 36 digits.

## Output

Returns a JSON object containing the cardinal word form (e.g. 'one thousand and five'), the ordinal word form (e.g. 'one thousand and fifth'), a numeric ordinal (e.g. '1,005th'), the style used (us/uk), digit count, and the original source value. May include a summary and degraded flag if the input was at the edge of supported range.

## 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": [
      "value"
     ],
     "properties": {
      "style": {
       "enum": [
        "us",
        "uk"
       ],
       "type": "string",
       "description": "us (default: one hundred five) or uk (one hundred and five, one thousand and five)"
      },
      "value": {
       "type": "string",
       "description": "The number, for example 1234, -12.5 or 1,000,000 (up to 36 digits, up to 20 decimals)"
      },
      "negative": {
       "enum": [
        "minus",
        "negative"
       ],
       "type": "string",
       "description": "minus (default) or negative"
      },
      "hyphenate": {
       "type": "boolean",
       "description": "true (default) writes twenty-one; false writes twenty one"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "style": {
       "type": [
        "null",
        "string"
       ]
      },
      "value": {
       "type": [
        "null",
        "string"
       ]
      },
      "digits": {
       "type": [
        "null",
        "number"
       ]
      },
      "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"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/number-words-english-cardinal-ordinal-4438b8a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from number-words.x402tookit.com](https://www.zero.xyz/host/number-words.x402tookit.com/llms.txt)