Données sur une devise

Ce endpoint renvoi les données disponibles sur une devise (nom, code, détails sur le symbole, informations sur les séparateurs, etc).

Request

GET  https://connect.visamundi.io/v3/currency/{id}

Dans cette requête, {id} doit être remplacé par un code de devise suivant la norme ISO 4217 à 3 lettres.

Example:

GET  https://connect.visamundi.io/v3/currency/EUR

Parameters of the request

ParameterDescription
access_tokenRequiredThe key to authenticate you to the API.
Learn more about authentication
languageOptionalLearn more about available languages

Response example

{
    "success": true,
    "statusCode": 200,
    "code": "ok",
    "data": {
        "currency": {
            "name": "Euro",
            "code": "EUR",
            "symbol": {
                "left": "",
                "right": "€",
                "padding": true
            },
            "thousands_separator": ".",
            "decimal_separator": ",",
            "decimals": 2,
            "is_indexed_to_dollar": false,
            "countries": [
                "AND",
                "AUT",
                "BEL",
                "CYP",
                "DEU",
                "ESP",
                "EST",
                "FIN",
                "FRA",
                "GRC",
                [...]
            ]
        }
    }
}

Parameters of the response

In the response, data contains an object currency avec plusieurs éléments :

Parameter/ObjectDescription
nameNom de la devise.
codeCode devise à 3 lettres basé sur la norme ISO 4217.
symbolSymbole détaillé de la devise permettant son formatage (Ex : 100,00 €)
- Key left Partie du symbole se situant à gauche du montant.
- Key right Partie du symbole se situant à droite du montant.
- Key padding Booléen indiquant si les parties gauche et droite sont séparées du montant par un espace.
thousands_separatorSéparateur des milliers.
decimal_separatorSéparateur des décimales.
decimalsNom de décimales.
is_indexed_to_dollarBooléen indiquant si la devise est indexée sur le Dollar US.
countriesCodes des pays utilisants cette devise.
Learn more about country codes

Codes and error messages

In addition to the API error codes and messages, ce endpoint peut renvoyer d’autres codes et messages :

StatusCodeCodeDescription
200no_currency_found« No currency found »
La requête s’est bien déroulée mais aucune devise n’a été trouvée.