Invertexto icon

Invertexto

Interact with Invertexto API
Join our community

Actions14

Overview

This node interacts with the Invertexto API to convert numbers into their word representation. It supports converting numeric values into words in different languages and optionally formats them as currency amounts. This is useful in scenarios such as generating human-readable financial reports, writing checks, or creating invoices where numbers need to be spelled out in words.

For example:

  • Converting 123 to "one hundred twenty-three" in English.
  • Converting 45.67 to "quarenta e cinco reais e sessenta e sete centavos" in Portuguese with currency formatting for Brazilian Real (BRL).

Properties

Name Meaning
Number The numeric value to convert into words.
Language The language for the conversion. Options: Portuguese (pt), English (en).
Currency Optional currency code (e.g., BRL for Brazilian Real). If provided, formats output as currency words.

Output

The node outputs a JSON object containing the converted number in words. The exact structure depends on the API response but generally includes the spelled-out number string. For example:

{
  "text": "one hundred twenty-three"
}

or with currency:

{
  "text": "one hundred twenty-three dollars and forty-five cents"
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active API key credential for the Invertexto API.
  • The node makes HTTP GET requests to https://api.invertexto.com/v1/number-to-words.
  • No additional environment variables are needed beyond the API key configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Providing unsupported language codes or invalid currency codes may result in API errors or unexpected output.
    • Very large numbers or non-numeric inputs might not be handled correctly by the API.

  • Error messages:

    • Authentication errors typically indicate problems with the API key; verify that the key is correct and has necessary permissions.
    • Validation errors from the API may indicate incorrect parameter formats; ensure the number is numeric, language is either pt or en, and currency codes follow standard ISO format.
    • Network errors suggest connectivity issues; check internet access and API endpoint availability.

Links and References

Discussion