Number To Text

Number To Text

Finance Math & Calculations Credits / request: 1

Converts a number or money amount to words in TR, EN, DE, ET, LV, LT, FI.

GET https://api.apikodu.com/api/v1/math/numbertotext
Documentation
Overview

Converts a number to words (optional currency).

Authentication

Every request requires the x-api-key header. Credits used and remaining quota are returned in response headers (x-api-credits-used, x-api-remaining-credits, x-rate-limit-*).

Request
GET https://api.apikodu.com/api/v1/math/numbertotext?amount=1234.56&language=en&currency=EUR
Query string. amount or value.
Parameters
Name Type Required Default Options Description
amount number Optional — — Amount.
value number Optional — — Number used if amount is empty.
language string Optional en tr en de et lv lt fi Language.
currency string Optional — — ISO currency. Empty writes a plain number.
Response
Name Type Description
text string Lowercase words. When currency is set, the unit name is appended (euros and cents ...).
language string Language code used (tr, en, de, et, lv, lt, fi).
currency string ISO currency code. Null for a plain number.
value number Number that was converted (amount or value).
Errors
HTTP code Description
400 -241 amount/value missing, not a number, or |value| > 999999999999.99.
400 -244 language is not tr, en, de, et, lv, lt or fi.
401 -100 x-api-key is missing, empty, malformed, inactive, banned, expired, IP-restricted, or not allowed for this API.
429 -221 Per-minute request limit exceeded. Response headers: x-rate-limit-limit, x-rate-limit-remaining, x-rate-limit-reset.
429 — Package credit quota cannot cover this request. Body may be { error, limit, currentUsage, requestCost } (no code field).
500 -1 Unexpected server error. message is a generic error text without technical details.
Notes
  • Success body is { data: { ... } }. Error body is { code, message }. code is an ApiResponseCode enum value (negative integer).

Sample response

{
  "data": {
    "text": "one thousand two hundred thirty-four euros and fifty-six cents",
    "language": "en",
    "currency": "EUR",
    "value": 1234.56
  }
}

Code samples

  
      const response = await fetch('https://api.apikodu.com/api/v1/math/numbertotext', {
        method: 'GET',
        headers: {
          'x-api-key': 'YOUR_API_KEY'
        }
      });

      const data = await response.json();
      console.log(data);
  

  
      import requests

      headers = {
          'x-api-key': 'YOUR_API_KEY'
      }

      response = requests.get('https://api.apikodu.com/api/v1/math/numbertotext', headers=headers)
      print(response.json())
  

  
      using var client = new HttpClient();
      client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

      var response = await client.GetStringAsync("https://api.apikodu.com/api/v1/math/numbertotext");
      Console.WriteLine(response);
  

  
      $response = file_get_contents('https://api.apikodu.com/api/v1/math/numbertotext', false, stream_context_create([
          'http' => [
              'header' => "x-api-key: YOUR_API_KEY"
          ]
      ]));

      print_r(json_decode($response, true));
  

  
      curl -X GET 'https://api.apikodu.com/api/v1/math/numbertotext' \
        -H 'x-api-key: YOUR_API_KEY'

Start building in minutes

Create a free account, get your API key and send your first request in minutes.

Get started free