Number to words template

What it does

Words and ordinals

Returns both one thousand and one thousandth, so it fits amounts and positions.

Decimals too

Spells out the digits after the decimal point, for amounts and measurements.

One file

The whole page is a single HTML file with its styles and script inside.

Keeps your key private

The page calls a Vercel function in api/, which holds the key, checks the input and limits each visitor to 10 conversions a minute.

Runs locally in one command

npm run dev serves the page and runs the api/ functions together, the same way Vercel does, with no CLI to install.

How it works

The Vercel function: it checks the number and calls Number to Words.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

import { guard, callApi, respond, fail } from '../lib/apiverve.js';

// Up to 15 digits, an optional minus sign and up to 6 decimal places.
const NUMBER = /^-?\d{1,15}(\.\d{1,6})?$/;

/** GET /api/words?number=1234.5: the number written out in words, as an ordinal, and digit by digit. */
export async function GET(request) {
  const blocked = guard(request);
  if (blocked) return blocked;

  const number = (new URL(request.url).searchParams.get('number') || '').replace(/,/g, '').trim();
  if (!NUMBER.test(number)) return fail('Enter a number with up to 15 digits and 6 decimal places');

  return respond(() => callApi('numbertowords', { query: { number } }));
}

See the whole file on GitHub →

Deploy it

1. Get a free API key

   The free plan includes 200 credits a month, no card needed. Create your key.

2. Deploy it

   Click Deploy to Vercel. Vercel copies the repo to your GitHub account and asks for APIVERVE_API_KEY: paste your key there.

3. Open your app

   Vercel builds it and gives you a live URL, usually in about a minute. Every push to the repo redeploys it.

Try the Number to Words API — the call this template makes

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
  "status": "ok",
  "error": null,
  "data": {
    "number": 975.07,
    "words": "nine hundred seventy-five point zero seven",
    "ordinal": "nine hundred seventy-fifth point zero seven",
    "numberOfDigits_numeric": 3,
    "numberOfDigits_words": "three",
    "eachNumber": [
      "nine",
      "seven",
      "five"
    ],
    "afterDecimal": {
      "number": "07",
      "words": [
        "zero",
        "seven"
      ],
      "numberOfDigits_numeric": 2,
      "numberOfDigits_words": "two"
    },
    "locale": "en-US"
  }
}