> For the complete documentation index, see [llms.txt](https://developers.primeiropay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.primeiropay.com/pulling-our-fx-rates-1.md).

# 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="/files/-MGhfquobv7ViRjEPcAb" %}
Pulling FX Rates Json Request
{% endfile %}