The NumXlator Advantage: ----------- NumXlator is designed to cater to businesses that require professional translation with accurate grammar construction. **For instance:** **1,234,567** should be translated as **One Million, Two Hundred and Thirty-four Thousand, Five Hundred and Sixty-seven**. NOT **One Million Two Hundred and Thirty-four Thousand Five Hundred and Sixty-seven**. (Notice the "**,**"). **23** should be translated as **Twenty-three**. NOT **Twenty three**. (Notice the "**-**"). **411** should be translated as **Four Hundred and Eleven**. NOT **four hundred and eleven**. (Notice the "**Title Casing**").

Endpoint: ----------- POST https://numxlator.p.rapidapi.com/translation/translate If SUCCESS, HTTP Code 200 will be returned. **API Guide** ----------- **Request Headers** --header 'Content-Type: application/json' --header 'x-rapidapi-host: numxlator.p.rapidapi.com' --header 'x-rapidapi-key: <<your-rapidapi-key>>' **Request Body** **Sample request payload:** { "number":"1234567", "language":"en" } ***number*** This is the number to translate, and it is required. The number value can be a whole number (e.g., 4234324) or a fractional number (e.g., 32131.45 for English translation or 32131,45 for non-English translation). The number value can also be formatted (e.g., 32,131.45 for English translation or 32.131,45 for non-English translation). ***language*** This is the language or locale you want for the translation. It is a required field. Currently, NumXlator supports the following language codes: ar, cs, da, de, en, en-US, es, fi, fr, ha, hu. id, ig, it, ja, ko, ms, nl, no, pl, pt, ro, ru, sv, sw, th, tr, uz, vi, yo, and zh The following describes the language codes: ar -> عربي (Arabic) cs -> Czech da -> Danish de -> Deutsch (German) en -> English es -> Español (Spanish) fi -> Finnish fr -> Français (French) ha -> Hausa hu -> Hungarian id -> Indonesia ig -> Igbo it -> Italiano (Italian) ms -> Malayu (Malaysian) nl -> Nederlands no -> Norwegian pl -> Polish pt -> Português ro -> Romanian ru -> Русский (Russian) sw -> Swahili sv -> Swedish th -> Thai tr -> Turkish uz -> o'zbek (Uzbek) vi -> Tiếng Việt (Vietnamese) yo -> Yoruba zh -> 中国人 (Chinese) ja -> 日本語 (Japanese) ko -> 한국인 (Korean) ***useCommas*** This field is optional, and the default value is boolean true. It's used to indicate if the translation should include commas or not. For example, the payload { "number":"1234567", "language":"en", "useCommas":true } will translate in English as "One Million, Two Hundred and Thirty-four Thousand, Five Hundred and Sixty-seven" while { "number":"1234567", "language":"en", "useCommas":false } will translate as "One Million Two Hundred and Thirty-four Thousand Five Hundred and Sixty-seven" NB: Notice the removal of commas in the second translation. NB: When this field is absent, the API will use the default comma setting for the specified language. ***caseStyle*** This field is optional. It's used to indicate preferred case-styling for the translation. Valid values for this field are: UPPER - (e.g., ONE HUNDRED AND TWENTY-THREE) LOWER - (e.g., one hundred and twenty-three) TITLE - (e.g., One Hundred and Twenty-three). Note that the first letter of every word is in caps SENTENCE - (e.g., One hundred and twenty-three). Note that ONLY the first letter of the first word is in caps For example, the payload { "number":"1234567", "language":"en", "caseStyle":"UPPER" } will translate in English as "ONE MILLION, TWO HUNDRED AND THIRTY-FOUR THOUSAND, FIVE HUNDRED AND SIXTY-SEVEN" while { "number":"1234567", "language":"en", "caseStyle":"LOWER" } will translate as "one million, two hundred and thirty-four thousand, five hundred and sixty-seven" NB: When this field is absent, the API will use the default case-style setting for the specified language. This field is optional. It's used to indicate preferred case-styling for the translation. Valid values for this field are: UPPER - (e.g., ONE HUNDRED AND TWENTY-THREE) LOWER - (e.g., one hundred and twenty-three) TITLE - (e.g., One Hundred and Twenty-three). Note that the first letter of every word is in caps SENTENCE - (e.g., One hundred and twenty-three). Note that ONLY the first letter of the first word is in caps For example, the payload { "number":"1234567", "language":"en", "caseStyle":"UPPER" } will translate in English as "ONE MILLION, TWO HUNDRED AND THIRTY-FOUR THOUSAND, FIVE HUNDRED AND SIXTY-SEVEN" while { "number":"1234567", "language":"en", "caseStyle":"LOWER" } will translate as "one million, two hundred and thirty-four thousand, five hundred and sixty-seven" NB: When this field is absent, the API will use the default case-style setting for the specified language. **Sample request payload for financial translation** This API provides default support for 50 currencies and also allows you to add your own custom currency. Below are the supported currencies. ``` AED -> UAE Dirham ARS -> Argentine Peso AUD -> Australian Dollar BRL -> Real CAD -> Canadian Dollar CHF -> Swiss Franc CLP -> Chilean Peso CNY -> Yuan COP -> Colombian Peso CZK -> Koruna DKK -> Danish Krone DZD -> Algerian Dinar EGP -> Egyptian Pound EUR -> Euro GBP -> Pound GHS -> Cedi HKD -> Hong Kong Dollar HUF -> Forint IDR -> Rupiah INR -> Rupee IRR -> Iranian Rial ISL -> Shekel JPY -> Yen KES -> Kenyan Shilling KRW -> Won LBP -> Lebanese Pound MAD -> Moroccan Dirham MXN -> Mexican Peso MYR -> Ringgit NGN -> Naira NOK -> Norwegian Krone NTD -> New Taiwan Dollar NZD -> New Zealand Dollar PEN -> Sol PHP -> Philippine Peso PLN -> Złoty RON -> Leu RUB -> Ruble RWF -> Rwandan Franc SAR -> Saudi Riyal SEK -> Swedish Krona SGD -> Singapore Dollar THB -> Baht TRY -> Lira TZS -> Tanzanian Shilling UGX -> Ugandan Shilling USD -> US Dollar UZS -> Uzbekistani Som VND -> Đồng ZAR -> Rand ``` If you intend to translate for financial purposes, which will have currency names (e.g., dollar, pounds, euros, etc.) and subunits (e.g., cent, cents, penny, pence, etc.). Use any of the request payload formats below: For English translation (Using Shorter Payload) { "number":"1234567.89", "language":"en", "currencyCode":"USD" } OR (Using Longer Payload) { "number":"1234567.89", "language":"en", "currency": "dollar", "currencyInPluralForm": "dollars", "currencySubUnit": "cent", "currencySubUnitInPluralForm": "cents" } The two requests above will produce the same response. The shorter payload is more concise and simpler, as it automatically takes care of any currency singularization or pluralization, but does not offer customization The longer payload, however, is more verbose but offers you the currency customisation you may want, such as how you want your currency to be spelt for both the base currency (e.g., Dollar or Dollars) and subunit (e.g., Cent or Cents). For Arabic translation { "number":"1234567.89", "language":"ar", "currency": "ريال", "currencyInPluralForm": "ريال", "currencySubUnit": "هلالات", "currencySubUnitInPluralForm": "هلالات" } For Chinese translation { "number":"1234567.89", "language":"zh", "currency": "元", "currencyInPluralForm": "元", "currencySubUnit": "分", "currencySubUnitInPluralForm": "分" } For Spanish translation { "number":"1234567,89", "language":"es", "currency": "dólar", "currencyInPluralForm": "dólares", "currencySubUnit": "centavo", "currencySubUnitInPluralForm": "centavos" } NB: dólar is the Spanish translation for US Dollar (and Dolares if more than one Dolar) while centavo is the translation of cent (and centavos if more than one centavo). For the French translation { "number":"1234567,89", "language":"fr", "currency": "livre", "currencyInPluralForm": "livres", "currencySubUnit": "centime", "currencySubUnitInPluralForm": "centimes" } NB: Livre is the French translation for British Pound, while Centimes is french translation of pence (plural of penny). You can have it the way you want it - no hard rule. Also note that the four currency fields (currency, currencyInPluralForm, currencySubUnit, and currencySubUnitInPluralForm) are required for financial translation; otherwise, you will only get the ordinary translation. Also, currencySubUnit represents the sub-unit of the currency, and it assumes the standard (1/100 of the currency or currency/100). For example, the sub-unit for the Dollar currency is "Cent" while the sub-unit for the Pound currency is "Penny" and the plural form of "Penny" is "Pence". **Success Response** Response in English: { "formattedNumber": "1,234,567.89", "translatedNumber": "One Million, Two Hundred and Thirty-four Thousand, Five Hundred and Sixty-seven", "translatedDecimal": "Eighty-nine", "translatedFinancial": "One Million, Two Hundred and Thirty-four Thousand, Five Hundred and Sixty-seven dollars Eighty-nine cents", "moreTranslationDetails": null, "remainingCredits": 1099356 } Response in Arabic: { "formattedNumber": "1,234,567.89", "translatedNumber": "مليون ومئتان وأربعة وثلاثون ألفًا وخمسمائة وسبعة وستون", "translatedDecimal": "تسعة وثمانون", "translatedFinancial": "مليون ومئتان وأربعة وثلاثون ألفًا وخمسمائة وسبعة وستون دولارات تسعة وثمانون سنتًا", "moreTranslationDetails": "١٬٢٣٤٬٥٦٧٬.٨٩", "remainingCredits": 1099355 } Response in Chinese: { "formattedNumber": "123,4567", "translatedNumber": "一百二十三万四千五百六十七", "translatedDecimal": null, "translatedFinancial": "壹佰贰拾叁万肆仟伍佰陆拾柒元", "moreTranslationDetails": "1,234,567", "remainingCredits": 1099354 } Response in Spanish: { "formattedNumber": "1.234.567,89", "translatedNumber": "Un Millón Doscientos Treinta y Cuatro Mil Quinientos Sesenta y Siete", "translatedDecimal": "Ochenta y nueve", "translatedFinancial": "Un Millón Doscientos Treinta y Cuatro Mil Quinientos Sesenta y Siete dolares Ochenta y nueve centavos", "moreTranslationDetails": null, "remainingCredits": 1099353 } Response in French: { "formattedNumber": "1 234 567,89", "translatedNumber": "Un Million Deux Cent Trente-quatre Mille Cinq Cent Soixante-sept", "translatedDecimal": "Quatre-vingt-neuf", "translatedFinancial": "Un Million Deux Cent Trente-quatre Mille Cinq Cent Soixante-sept livres Quatre-vingt-neuf centimes", "moreTranslationDetails": null, "remainingCredits": 1099352 } ***formattedNumber*** The original number in formatted style. ***translatedNumber*** The translated number (whole number part). ***translatedDecimal*** The translated number (fractional part). This field will be null if the number in the request has no fractional part. ***translatedFinancial*** The translated number in monetary terms (contains both the whole number and the fractional part). This field will be null if the request doesn't contain the four currency fields (currency, currencyInPluralForm, currencySubUnit, and currencySubUnitInPluralForm). ***moreTranslationDetails*** This field holds any extra translation (if available or necessary); otherwise, the value is usually null. For instance, if you are translating into Arabic, this field will contain the Eastern-Arabic representation (e.g., ١٬٢٣٤٬٥٦٧.٨٩) of the number you are translating (e.g., 1,234,567.89 or 1234567.89). Also, if you are translating into Chinese, Japanese, or Korean, this field will contain the English representation (e.g., 1,234,567) of the number you are translating (e.g., 123,4567.89 or 1234567.89). **Error Response** ***code*** NumXlator application-specific error code. ***description*** Description of error. Sample error response:

{
    "code": "ERR_INV_NUM",
    "description": "The number entered for translation is not valid. Please, check and enter a valid number."
}