---
title: "Get supported countries"
description: "Retrieve the list of countries supported for transfers. Each country includes its two-letter and three-letter ISO codes and its local currency code where available."
protocol: rest
method: GET
endpoint: "/v1/transfer/supported-countries"
baseUrl: "https://api.gravv.xyz"
group: "Transfer"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get supported countries

<Endpoint method="GET" path="/v1/transfer/supported-countries" />

Retrieve the list of countries supported for transfers. Each country includes its two-letter and three-letter ISO codes and its local currency code where available.

## Query Parameters

<ParamField name="iso_code" query="iso_code" type="string">
  Filter by two-letter ISO 3166-1 alpha-2 country code (case-insensitive).
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | List of supported transfer countries |
| `400` | Bad request |

### 200 response

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

  <Expandable title="properties">
    <ResponseField name="countries" type="object[]">
      Array of supported countries.

      <Expandable title="properties">
        <ResponseField name="currency_code" type="string">
          Three-letter ISO 4217 currency code for the country's local currency. Returns `null` for countries where a local currency code is not available.
        </ResponseField>

        <ResponseField name="iso3_code" type="string">
          Three-letter ISO 3166-1 alpha-3 country code.
        </ResponseField>

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

        <ResponseField name="name" type="string">
          Full country name.
        </ResponseField>

      </Expandable>
    </ResponseField>

  </Expandable>
</ResponseField>

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

<ResponseExample>

```json title="Response"
{
  "data": {
    "countries": [
      {
        "currency_code": "NGN",
        "iso3_code": "NGA",
        "iso_code": "NG",
        "name": "Nigeria"
      },
      {
        "currency_code": "GHS",
        "iso3_code": "GHA",
        "iso_code": "GH",
        "name": "Ghana"
      },
      {
        "currency_code": "KES",
        "iso3_code": "KEN",
        "iso_code": "KE",
        "name": "Kenya"
      },
      {
        "currency_code": "USD",
        "iso3_code": "USA",
        "iso_code": "US",
        "name": "United States"
      },
      {
        "currency_code": null,
        "iso3_code": "JPN",
        "iso_code": "JP",
        "name": "Japan"
      }
    ]
  },
  "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**