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

# Transfers Overview

> Reviewed public transfer primitives for bank payouts and lifecycle checks

Use Zentra transfers to create bank payouts, retrieve transfer history, inspect payout fees, and follow transfer lifecycle state safely.

## Overview

This namespace is part of the reviewed public gateway surface.

## Reviewed Public Transfer Endpoints

* `POST /api/v1/transfers`
* `GET /api/v1/transfers`
* `GET /api/v1/transfers/{id}`
* `POST /api/v1/transfers/{reference}/verify`
* `POST /api/v1/transfers/{reference}/retry`
* `GET /api/v1/transfers/stats`
* `GET /api/v1/transfers/fees`
* `GET /api/v1/banks`

## What Transfers Covers

* tenant-scoped payout initiation
* payout history and lookup
* fee and stats inspection
* bank directory lookup
* webhook-driven lifecycle monitoring

## Integration Notes

* Amounts should be sent in minor units only.
* Use a stable `reference` for replay safety and reconciliation.
* Retrieval on the reviewed public gateway is by transfer `id`, while verify and retry operations are keyed by `reference`.
* Prefer webhooks for lifecycle updates instead of polling individual transfers aggressively.

## Compatibility Notes

* The reviewed public gateway does **not** currently include a reviewed `bulk transfer` or standalone `resolve account` route.
* Older SDK examples or tenant-specific integrations may still refer to `/transfers/bulk` or `/transfers/resolve-account`. Treat those as compatibility or separately issued surfaces unless your approved contract explicitly includes them.

## Quick Links

<CardGroup cols={2}>
  <Card title="Create Transfer" icon="plus" href="/api-reference/transfers/create">
    Initiate a bank transfer
  </Card>

  <Card title="List Transfers" icon="list" href="/api-reference/transfers/list">
    Query transfer history
  </Card>

  <Card title="Get Transfer" icon="eye" href="/api-reference/transfers/get">
    Retrieve one transfer by id
  </Card>

  <Card title="Banks" icon="building-columns" href="/api-reference/transfers/banks">
    Retrieve supported bank codes
  </Card>
</CardGroup>