---
title: "Get rates"
description: "Retrieve current exchange rates for transfers between different currencies."
protocol: rest
method: GET
endpoint: "/v1/transfer/rates"
baseUrl: "https://api.gravv.xyz"
group: "Transfer"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get rates

<Endpoint method="GET" path="/v1/transfer/rates" />

Retrieve current exchange rates for transfers between different currencies.

## Query Parameters

<ParamField name="page" query="page" type="integer" default="1">
  Page number for pagination
</ParamField>

<ParamField name="items_per_page" query="items_per_page" type="integer" default="10">
  Number of transactions per page
</ParamField>

<ParamField name="country_iso_code" query="country_iso_code" type="string">
  Use two-letter ISO country code to filter transfer rates
</ParamField>

<ParamField name="currency" query="currency" type="string">
  Use three-letter ISO currency code to filter transfer rates
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | Exchange rates retrieved successfully |
| `400` | Bad request |

### 200 response

<ResponseField name="data" type="object">

  <Expandable title="properties">
    <ResponseField name="items" type="object[]">

      <Expandable title="properties">
        <ResponseField name="country_iso_code" type="string">
          Two-letter ISO 3166-1 alpha-2 country code.
        </ResponseField>

        <ResponseField name="currency" type="string">
          Three-letter ISO 4217 currency code.
        </ResponseField>

        <ResponseField name="eur_rate" type="number">
          Exchange rate against EUR.
        </ResponseField>

        <ResponseField name="usd_rate" type="number">
          Exchange rate against USD.
        </ResponseField>

      </Expandable>
    </ResponseField>

    <ResponseField name="items_per_page" type="integer">
      Number of items returned per page.
    </ResponseField>

    <ResponseField name="page" type="integer">
      Current page number.
    </ResponseField>

    <ResponseField name="total_pages" type="integer,null">
      Total number of pages. Null when the total count is unavailable.
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseField name="error" type="string">
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "data": {
    "items": [
      {
        "country_iso_code": "NG",
        "currency": "NGN",
        "eur_rate": 1411.641026432,
        "usd_rate": 1260.3937736
      }
    ],
    "items_per_page": 1,
    "page": 1,
    "total_pages": 1
  },
  "error": null
}
```

</ResponseExample>

### 400 response

<ResponseField name="data" type="null">
</ResponseField>

<ResponseField name="error" type="string">
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "data": null,
  "error": "invalid request payload"
}
```

</ResponseExample>

## Authorization

- **ApiKeyAuth**