# Get Currencies
source: https://developer.mastercard.com/payment-currency-conversion/documentation/use-cases/currencies/index.md

This example flow demonstrates the use of a **Currencies** API call to get the latest list of currencies for which Mastercard publishes rates daily. That list facilitates which receiving countries and currencies are shown in the app, from which Ali chooses Martha's receiving currency, GBP.

This example does not prescribe the design and interactions of your funds transfer solution; those aspects are for you to define. For details of using the API and sample requests and responses, see [API Reference](https://developer.mastercard.com/payment-currency-conversion/documentation/api-reference/index.md). If an API request fails validation, Mastercard returns an error response, see [Error Codes (Reason Codes)](https://developer.mastercard.com/payment-currency-conversion/documentation/codes-and-formats/index.md#error-codes-reason-codes).

### Example screens {#example-screens}

Some example mobile app screens are shown below --- the numbers relate to the steps in the sequence diagram.

![](https://static.developer.mastercard.com/content/payment-currency-conversion/documentation/images/mastercard-send-ccc-screens-currencies.png)

### Example sequence {#example-sequence}

Diagram mastercard-send-sequence-currencies

The example sequence shows:

1. Periodically, you send a [Currencies API](https://developer.mastercard.com/payment-currency-conversion/documentation/api-reference/index.md) GET request to get the list of currencies for which Mastercard publishes rates daily. You can make this call without any query parameters, which causes the API to use today's date.

2. Mastercard returns a Currencies API response (200) with the alpha codes and names of each currency. Example response:

```json
{
  "requestInformation": {
    "name": "payment transaction currencies",
    "description": "A list of mastercard active currencies",
    "requestDate": "2024-06-12 17:29:43 GMT"
  },
  "data": {
    "currencyCount": 151,
    "mastercardCurrencies": [
      {
        "alphaCd": "AFN",
        "currNam": "AFGHANISTAN AFGHANI"
      },
      {
        "alphaCd": "ALL",
        "currNam": "ALBANIAN LEK"
      },

      ...

    ]
  }
}
```

3. Your systems filter the returned list against the countries your implementation supports to derive a list of available receiving countries and currencies for your app.

4. Ali opens the app, which causes it to retrieve the latest data from your systems, including the list of available receiving countries and currencies.

5. Your systems send the list and other data to the app.

6. Ali chooses the 'International' panel to start the cross-border transfer flow. The panel shows the previous transfer's receiving currency, Chilean Peso (CLP), if it is still in the list of receiving currencies.

   You can use a **Conversion Rate Details** API call to get the current CLP to USD conversion rate, see the [Get Conversion Details](https://developer.mastercard.com/payment-currency-conversion/documentation/use-cases/conv-details/index.md) example flow.
7. The app panel shows the calculated USD to CLP conversion rate.

8. Ali taps CLP to change receiving currency.

9. The 'Select recipient country' app panel shows the available receiving countries and currencies, with CLP already selected.

10. Ali selects GBP and returns to 'International' panel.

    You can use a **Conversion Rate Details** API call to get the current GBP to USD conversion rate, see the [Get Conversion Details](https://developer.mastercard.com/payment-currency-conversion/documentation/use-cases/conv-details/index.md) example flow.
11. The app panel shows GBP selected and the calculated USD to GBP conversion rate.

    Ali continues with the cross-border transfer flow.