Get a list of countries and currencies

Use this Tango API endpoint to retrieve a list of countries in your Tango catalog along with each country’s preferred currency. Filtering your catalog by country and currency helps simplify the recipient experience by showing only relevant gift cards.

Wondering what currency to display first as the default currency? Use the GET /rewardCountries to determine the preferred currency. You can also filter and get the reward country data such as the name of the country. You can list the countries that include "united" in their name. The search entry "united" is not case-sensitive. Use the pagination feature to walk through the fill list.

📘

Note:

We accept AUD, CAD, EUR, GBP, and USD for Global Choice Link products. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified.

Endpoint

Acme Health wants to offer a streamlined reward experience to its recipients in France. They use this endpoint to determine EUR is the preferred currency, and make it the default view. Instead of showing all 100 eligible gift cards at once, they group rewards by currency so that EUR options appear first, while still allowing access to other currencies if needed. They also use country metadata to personalize labels, searches, and relevant filtering—resulting in a clearer, more user‑friendly catalog.

Endpoint

Use this endpoint to get a list of countries and their preferred currency.

Parameters

Use the following query parameters with this endpoint. Use pagination to go through the list:

Examples

The following example payload is returned when you choose "EUR" as preferredCurrencies and "3" for maxResults. If maxResults is not selected, you will get ten listed. The maximum number of results that can be returned is 200.

{
  "prevCursor": null,
  "nextCursor": "MTE=",
  "prevPageAvailable": false,
  "nextPageAvailable": true,
  "maxResults": 3,
  "items": [
    {
      "twoLetterCode": "FR",
      "threeLetterCode": "FRA",
      "countryName": "France",
      "preferredCurrency": "EUR"
    },
    {
      "twoLetterCode": "DE",
      "threeLetterCode": "DEU",
      "countryName": "Germany",
      "preferredCurrency": "EUR"
    },
    {
      "twoLetterCode": "IT",
      "threeLetterCode": "ITA",
      "countryName": "Italy",
      "preferredCurrency": "EUR"
    }
  ],
  "numberOfElements": 3
}

Here's an example payload for when you receive an error:

{
  "timestamp": "2025-02-21T23:23:13.930Z",
  "requestId": "string",
  "path": "string",
  "httpCode": 0,
  "httpPhrase": "string",
  "i18nKey": "string",
  "message": "The error message will show here for error codes ",
  "errors": [
    {}
  ]
}

Response codes

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages: