# Pulling our FX Rates

**Via API**

The following command authenticates you with your API credentials that you use for payment processing and returns the FX Rate upon successful authentication

**Command-line example with curl**

```
https://reports.primeiropay.com/fx?username=XXXXXXX&merchantId=XXXXXX&password=XXXXX
```

if the authentication fails, you will receive:

```
{
   "reason" : "INVALID_USER_AUTHENTICATION",
   "message" : "Failed to authenticate principal, user and/or password invalid"
}
```

If the authentication is successful you will be returned with the current valid FX Rates:

**Please note that only your settlement currency pair is being returned. If you wish to change your settlement currency, please contact your Account Manager.**

```
{
  "rate" : [ {
    "currency_pair" : "BRLUSD",
    "rate" : "3.795674",
    "valid_until" : "2015-01-15 15:00:00.0"
  } ]
}
```

{% file src="<https://1991843971-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MGcOwWYO42hhJYXrYx1%2F-MGheG66QiTS8gPQtjb_%2F-MGhfquobv7ViRjEPcAb%2FFX%20Rates.rar?alt=media&token=ee1b3ec1-b2d3-4249-a2fc-d5d000f88398>" %}
Pulling FX Rates Json Request
{% endfile %}