Pair Requests

Documentation for the Pair ExchangeRate-API endpoint.

To use our Pair endpoint simply make the substitutions explained below and then send a GET request.

• Substitute `YOUR-API-KEY` with the API key displayed in your dashboard.

• Substitute `EUR` with the code you want to use as a base currency.

• Substitute `GBP` with the code you want to use as a target currency.

We use ISO 4217 Three Letter Currency Codes - e.g. USD for US Dollars, EUR for Euro etc. Here are the codes we support.

GET https://pro.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP

This will return the exchange rate from your base code to the other currency you supplied:

{
	"result": "success",
	"documentation": "https://www.exchangerate-api.com/docs",
	"terms_of_use": "https://www.exchangerate-api.com/terms",
	"time_last_update_unix": 1585267200,
	"time_last_update_utc": "Fri, 27 Mar 2020 00:00:00 +0000",
	"time_next_update_unix": 1585270800,
	"time_next_update_utc": "Sat, 28 Mar 2020 01:00:00 +0000",
	"base_code": "EUR",
	"target_code": "GBP",
	"conversion_rate": 0.8412
}

Alternatively, you could also supply an optional AMOUNT variable (decimal format xxxx.xxxx).

GET https://pro.exchangerate-api.com/v6/YOUR-API-KEY/pair/EUR/GBP/AMOUNT

This will return the exchange rate from your base code to the target currency you supplied, as well as a conversion of the amount you supplied:

{
	"result": "success",
	"documentation": "https://www.exchangerate-api.com/docs",
	"terms_of_use": "https://www.exchangerate-api.com/terms",
	"time_last_update_unix": 1585267200,
	"time_last_update_utc": "Fri, 27 Mar 2020 00:00:00 +0000",
	"time_next_update_unix": 1585270800,
	"time_next_update_utc": "Sat, 28 Mar 2020 01:00:00 +0000",
	"base_code": "EUR",
	"target_code": "GBP",
	"conversion_rate": 0.8412,
	"conversion_result": 5.8884
}

Error Responses

{
	"result": "error",
	"error-type": "unknown-code"
}

Where "error-type" can be any of the following:

  • "unsupported-code" if we don't support the supplied currency code (see supported currencies...).
  • "malformed-request" when some part of your request doesn't follow the structure shown above.
  • "invalid-key" when your API key is not valid.
  • "quota-reached" when your account has reached the the number of requests allowed by your plan.
  • "not-available-on-plan" if your plan level doesn't support this type of request or endpoint.
  • "not-available-on-endpoint" if your request was sent to our free.exchangerate-api.com endpoint.

If you have any questions about the above please don't hesitate to email us!