---
title: "Transfers overview"
description: "Move funds and retrieve transfer requirements."
---

# Transfers overview

Use the Transfers API to move funds and retrieve supported currencies, countries, address requirements, and rates.

<CardGroup cols={2}>
  <Card title="Browse transfer endpoints" icon="code" href="/api-reference/transfer/post-v1-transfer">
    Create a transfer or browse the operations in this category.
  </Card>
  <Card title="Transfers integration guide" icon="book" href="/platform/transfers/overview">
    Choose and implement the appropriate transfer flow.
  </Card>
</CardGroup>

## How it works

A single endpoint — [`POST /v1/transfer`](/api-reference/transfer/post-v1-transfer) — moves funds between internal accounts, external accounts (recipients), and crypto wallets. The destination type determines the flow:

| Flow | Destination | Guide |
|---|---|---|
| Internal | Another Gravv account | [Internal transfers](/platform/transfers/internal-transfers) |
| External | A verified [external account](/api-reference/external-accounts/overview) | [External transfers](/platform/transfers/external-transfers) |
| International | A recipient in another country/currency | [International transfers](/platform/transfers/international-transfers) |
| Crypto | A blockchain wallet | [Crypto transfers](/platform/transfers/crypto-transfers) |

Before initiating cross-currency or international transfers, use the discovery endpoints to confirm the corridor is supported and fetch the current rate.

## Endpoints

| Endpoint | Description |
|---|---|
| [`POST /v1/transfer`](/api-reference/transfer/post-v1-transfer) | Initiate a transfer between internal accounts, external accounts, or crypto wallets |
| [`GET /v1/transfer/rates`](/api-reference/transfer/get-v1-transfer-rates) | Current exchange rates for cross-currency transfers |
| [`GET /v1/transfer/supported-currencies`](/api-reference/transfer/get-v1-transfer-supported-currencies) | Fiat currencies supported for transfers |
| [`GET /v1/transfer/supported-countries`](/api-reference/transfer/get-v1-transfer-supported-countries) | Supported countries with ISO codes and local currency |
| [`GET /v1/transfer/supported-countries-for-address`](/api-reference/transfer/get-v1-transfer-supported-countries-for-address) | Countries supported for recipient addresses, with `states` where applicable |

## Authentication

All requests use `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header. Write requests should include an `Idempotency-Key` header to make retries safe — see [Idempotent requests](/getting-started/idempotent-requests).