# National Bank’s currency exchange rate history

This method allows retrieving an exchange rate by National Bank for a requested currency to a Georgian Lari by a period. A method returns a currency exchange rate for each date within a requested period.

:::note
This method is rate limited — 60 requests per minute are allowed. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header (in seconds).
:::

## Query params

- `currency` — string, required

  A currency code in the ISO 4217 format (e.g.: USD, GEL).

- `startDate` — date, required

  A start date for a period.

- `endDate` — date, required

  An end date for a period.

**REQUEST**

```api
GET api/rates/nbg/{currency}/{startDate}/{endDate}
```

## Response

- `Date` — date

  A date.

- `Rate` — decimal number

  An exchange rate by a National Bank for a given currency.

- `Currency` — string

  A currency code in the ISO 4217 format (e.g: USD, GEL).

**JSON**

```json
[
  {
    "Date": "2021-06-21T11:46:16.4280359+04:00",
    "Rate": 2.0,
    "Currency": "sample string 3"
  },
  {
    "Date": "2021-06-21T11:46:16.4280359+04:00",
    "Rate": 2.0,
    "Currency": "sample string 3"
  }
]
```

**xml**

```xml
<ArrayOfNbgCurrencyHistory xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CIBApi.Models">
  <NbgCurrencyHistory>
    <Currency>sample string 3</Currency>
    <Date>2021-06-21T11:46:16.4280359+04:00</Date>
    <Rate>2</Rate>
  </NbgCurrencyHistory>
  <NbgCurrencyHistory>
    <Currency>sample string 3</Currency>
    <Date>2021-06-21T11:46:16.4280359+04:00</Date>
    <Rate>2</Rate>
  </NbgCurrencyHistory>
</ArrayOfNbgCurrencyHistory>
```