---
title: Convert Number to Words API
slug: convert-number-to-words
url: https://apyhub.com/modernsoftware-pro/service/convert-number-to-words
provider: ModernSoftware.pro
categories: [Developer Tools, Finance, Standard Data]
tags: [number-conversion, number-to-words, currency-formatting, localization, text-formatting]
auth: apikey
version: 1.0
service_type: sync
endpoints: 2
atoms: 10
mcp: true
---

# Convert Number to Words API

Spell numbers into words in 26 languages. Supports cardinal forms and currency amounts for localized invoices, forms, and reports.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/single/number` | What it does Converts the input number into its word representation for the specified language. The… | 10 |
| POST | `https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/batch/number` | What it does Converts a batch of numbers into their word representations and returns the converted… | 10 |

## Endpoint reference

### Converts a single number to its word representation.

`GET https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/single/number` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `case` | query | string | no | One of: lower, upper, sentence, title. |
| `form` | query | string | no | cardinal (default) or currency:{CODE}, e.g. currency:USD |
| `number` | query | string | yes | Digits only, e.g. 1234 or 99.50. Decimals allowed only for currency. |
| `language` | query | string | yes | One of: al, fr_BE, pt_BR, bg, cs, dk, nl, en, et, ka, de, fr, hu, it, lt, lv, mk, pl, pt, ro, sr, sk, es, sv, tr, ua. |

#### Quickstart

Convert a number to words with the language and formatting you choose.

```bash
curl -X GET "https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/single/number?number=25&language=en" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `number`, `language`, `form`, `case`, and `words` fields. `words` contains the spelled-out result as a string. `form` and `case` describe the used form and letter case - if you have not defined them in the request, you will see default values here.

```json
{
  "number": "25",
  "language": "en",
  "form": "cardinal",
  "case": "lower",
  "words": "twenty-five"
}
```

### Converts a batch of up to 20 numbers to their word representations.

`POST https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/batch/number` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `items` | body | array of object | yes | The numbers to convert, in the same order they should appear in the response. At least 1 and at most 20 entries are accepted; submitting more than 20 returns an error. |
| `items[].case` | body | string | no | One of: lower, upper, sentence, title. |
| `items[].form` | body | string | no | cardinal (default) or currency:{CODE}, e.g. currency:USD. |
| `items[].number` | body | string | yes | Digits only, e.g. 1234 or 99.50. Decimals allowed only for currency. |
| `items[].language` | body | string | yes | One of: al, fr_BE, pt_BR, bg, cs, dk, nl, en, et, ka, de, fr, hu, it, lt, lv, mk, pl, pt, ro, sr, sk, es, sv, tr, ua. |

#### Quickstart

Convert one or more numbers to words by sending the required `items` array in the request body.

```bash
curl -X POST "https://api.eu.apyhub.com/modernsoftware-pro/convert-number-to-words/batch/number" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "number": "25",
        "language": "en"
      }
    ]
  }'
```

#### What you'll get back

Returns a JSON object with an `items` array. Each item includes the original `number`, `language`, plus a `words` string with the number spelled out in words. `form` and `case` describe the used form and letter case - if you have not defined them in for the given item, you will see default values here.

```json
{
  "items": [
    {
      "number": "25",
      "language": "en",
      "form": "cardinal",
      "case": "lower",
      "words": "twenty-five"
    }
  ]
}
```

## About

## What it does
Convert Number to Words API , converts a single number or a batch of up to 20 numbers into spelled-out text in multiple languages. Send digits and a target language, and get the word form back in the same order you submitted them.

Use the GET endpoint for one value or the POST endpoint when you need to process a list. Each item accepts `number` and `language`, and can also include `case` and `form`. `case` controls output casing with `lower`, `upper`, `sentence`, or `title`. `form` defaults to `cardinal`, or you can request `currency:{CURRENCY}` for supported currencies when you need amounts expressed as currency names and values in words.

The response returns the original `number`, the selected `language`, `form`, `case`, and the generated `words` string. Whole numbers from 0 up to 999,999,999,999,999 are accepted, and currency mode supports fractional values with up to 2 digits. Supported languages include English, French, German, Spanish, Portuguese, Dutch, Italian, Polish, Turkish, and others listed in the schema.

Use Number to Words when you need readable amounts on invoices, checks, statements, reports, or localized user interfaces where numeric values should be spelled out consistently.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/modernsoftware-pro/service/convert-number-to-words