---
title: "Get supported currencies"
description: "Retrieve the list of fiat currencies supported for transfers."
protocol: rest
method: GET
endpoint: "/v1/transfer/supported-currencies"
baseUrl: "https://api.gravv.xyz"
group: "Transfer"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get supported currencies

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

Retrieve the list of fiat currencies supported for transfers.

## Query Parameters

<ParamField name="code" query="code" type="string">
  Filter by three-letter ISO 4217 currency code (case-insensitive).
</ParamField>

<ParamField name="name" query="name" type="string">
  Filter by currency name (case-insensitive partial match).
</ParamField>

## Responses

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

### 200 response

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

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

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

        <ResponseField name="name" type="string">
          Full name of the currency.
        </ResponseField>

      </Expandable>
    </ResponseField>

  </Expandable>
</ResponseField>

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

<ResponseExample>

```json title="Response"
{
  "data": {
    "currencies": [
      {
        "code": "NGN",
        "name": "Nigerian Naira"
      },
      {
        "code": "EUR",
        "name": "Euro"
      },
      {
        "code": "GHS",
        "name": "Ghanaian Cedi"
      },
      {
        "code": "KES",
        "name": "Kenyan Shilling"
      },
      {
        "code": "UGX",
        "name": "Ugandan Shilling"
      },
      {
        "code": "ZMW",
        "name": "Zambian Kwacha"
      },
      {
        "code": "XOF",
        "name": "West African CFA Franc"
      },
      {
        "code": "BWP",
        "name": "Botswana Pula"
      },
      {
        "code": "CDF",
        "name": "Congolese Franc"
      },
      {
        "code": "XAF",
        "name": "Central African CFA Franc"
      },
      {
        "code": "MWK",
        "name": "Malawian Kwacha"
      },
      {
        "code": "RWF",
        "name": "Rwandan Franc"
      },
      {
        "code": "ZAR",
        "name": "South African Rand"
      },
      {
        "code": "TZS",
        "name": "Tanzanian Shilling"
      },
      {
        "code": "USD",
        "name": "US Dollar"
      }
    ]
  },
  "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**