Localized Sentence

Translate monetary values into equivalent localized sentence.

Any numeric value signifying an amount of money can easily be translated to the sentence equivalent in any language of choice.

To better understand the concept of translation, we've come up with a series of example that better explain it:

Amount

Currency

Language

Translation

2000

USD

English (en)

Two thousand dollars only.

329.99

GBP

English (en)

Three hundred and twenty-nine pounds, ninety-nine sterling only.

329.99

GBP

French (fr)

trois cent vingt-neuf livres, quatre-vingt-dix-neuf penny seulement

434103.34

NGN

English (en)

Four hundred and thirty-four thousand, one hundred and three naira, thirty-four kobo only.

八百七十二万七千八百二十四

USD

English (en)

Twenty-four dollar, forty-five cent only

八百七十二万七千八百二十四

GBP

Arabic (ar)

أربعة وعشرون نيرة ، خمسة وأربعون كوبو فقط

Customize: To change the destination translation language, or currency, kindly check customizing translation.

Sample API Request

get
Get translation

https://tuforty.com/api/v1/translator/money
Translate money value into words
Request
Response
Request
Headers
Authorization
required
string
Bearer authentication token (See Authentication).
Query Parameters
value
required
string
Money value to translate (must be equal or greater than zero).
currency
required
string
Currency to use for the value specified (e.g. GBP, USD, INR).
language
required
string
Language to translate into (see supported languages).
use_short
optional
boolean
Use shorter form of a currency to generate a a translation. Example: Given the currency CAD, the: - short form is Dollar & Cent - long form is Canadian Dollar & Cent By default, use_short is true.
Response
200: OK
Full money value translation, alongside a complete breakdown of the whole and decimal parts.
{
"whole_unit": "pound",
"decimal_unit": "penny",
"language": "fr",
"currency": "GBP",
"translation": "trois cent vingt-neuf livres, quatre-vingt-dix-neuf penny seulement",
"whole_translation": "trois cent vingt-neuf",
"decimal_translation": "quatre-vingt-dix-neuf"
}
402: Payment Required
Translation quota has been exhausted. Try purchasing a new quota.
{
"message": "Not enough quota to perform this request."
}
500: Internal Server Error
{
"message": "An error occured; We've notified our dev team already."
}