> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talescria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfers between your accounts

> Move money between your own accounts, including across currencies.

A transfer moves money between two of **your own** accounts: GBP to NGN to fund a local payroll account, or from "Operations" to "Payroll" in the same currency. To pay someone else, [send a payment](https://docs.talescria.com/guides/payments.md) instead.

Scopes: `transfers:write` to quote and transfer, `transfers:read` to check. `transfers:write` moves money.

## Same currency

```bash curl theme={null}
curl https://api.talescria.com/v1/conversions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: fund-payroll-2026-11" \
  -H "Content-Type: application/json" \
  -d '{
    "fromAccountId": "acct_…operations",
    "toAccountId": "acct_…payroll",
    "minorUnits": "500000"
  }'
```

```python Python theme={null}
resp = requests.post(
    "https://api.talescria.com/v1/conversions",
    headers={"Authorization": f"Bearer {token}", "Idempotency-Key": "fund-payroll-2026-11"},
    json={"fromAccountId": operations_id, "toAccountId": payroll_id, "minorUnits": "500000"},
    timeout=30,
)
conversion = resp.json()["conversion"]
```

## Different currencies

**1. Quote**

Give exactly one amount: what leaves (`amountFromMinorUnits`) or what arrives (`amountToMinorUnits`).

```bash theme={null}
curl https://api.talescria.com/v1/conversions/quotes \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fromAccountId": "acct_…gbp", "toAccountId": "acct_…ngn", "amountFromMinorUnits": "100000"}'
```

The quote's `amountFromMinorUnits` and `amountToMinorUnits` are what will move. `rateMicro` is the rate × 1,000,000, for display. The quote expires at `expiresAt`.

**2. Transfer with the quote**

```bash theme={null}
curl https://api.talescria.com/v1/conversions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: fx-gbp-ngn-2026-11-14" \
  -H "Content-Type: application/json" \
  -d '{"fromAccountId": "acct_…gbp", "toAccountId": "acct_…ngn", "quoteRef": "<quoteRef>"}'
```

The quoted amounts are used, so there's no `minorUnits`. An expired or used quote is `409 QUOTE_UNUSABLE`: get a new one.

## Outcome

| `status` | Meaning |
| - | - |
| `pending` | The money is reserved and hasn't arrived yet. Poll `GET /v1/conversions/{conversionRef}`. |
| `settled` | Done. The money is in the destination account. |
| `failed` | It didn't happen. The reserved amount is released. |

A `200` instead of `201` means your idempotency key already named a transfer, which is returned unchanged. Keep idempotency keys for transfers to **100 characters or fewer**.

## What can't move

Some pairs of accounts can't transfer to each other, for example when the two accounts are held at different banking partners. That's `422 UNSUPPORTED`. Not enough available balance is `402 INSUFFICIENT_FUNDS`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.