---
title: "Get a payout"
method: GET
path: "/payouts/{id}"
tags: ["Payouts"]
---

# Get a payout

`GET /payouts/{id}`

Retrieves a payout by its `id`. Only payouts matching the `live` or `test` mode of the API key are visible.

## Path parameters

- `id` string, required

## Response `200`

The payout.

- PayoutsPayout — A payout is a transfer of funds Fintoc settles to a recipient bank account. Each payout groups the payment intents, charges, and refunds it disburses or discounts.
  - `id` string, required — Unique identifier of the payout.
  - `object` 'payout', required — Type of the object. Always `payout`.
  - `amount` integer, required — Value disbursed, in the smallest unit of the currency. CLP has no decimals, so amounts are in pesos. MXN amounts are in centavos.
  - `created_at` string, date-time, required — ISO 8601 timestamp, in UTC, of when Fintoc created the payout.
  - `currency` string, required — Three-letter ISO 4217 currency code, returned in uppercase.
  - `mode` 'test' | 'live', required — Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing.
  - `recipient_account` PayoutsRecipientAccount, required — Bank account that receives the payout.
    - `holder_id` string, required — Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico).
    - `institution_id` string, required — Fintoc identifier of the institution that holds the account, such as `cl_banco_estado`.
    - `number` string, required — Account number. In Mexico, an 18-digit CLABE (Clave Bancaria Estandarizada).
    - `type` 'checking_account' | 'sight_account' | 'rut_account' | 'fsa_account', required — Account subtype. One of `checking_account`, `sight_account` (Chilean cuenta vista), `rut_account` (BancoEstado CuentaRUT), or `fsa_account` (Mexican FSA account).
  - `status` 'in_progress' | 'succeeded' | 'canceled' | 'returned', required — Status of the payout. One of `in_progress` (Fintoc is processing the transfer), `succeeded` (the funds reached the recipient account), `canceled` (the payout failed or was canceled before sending the funds), or `returned` (the receiving institution returned the funds).
  - `succeeded_at` string, date-time, nullable, required — ISO 8601 timestamp, in UTC, of when the payout succeeded. `null` until the payout succeeds.
  - `updated_at` string, date-time, required — ISO 8601 timestamp, in UTC, of when Fintoc last updated the payout.

## Other responses

- `401` — Invalid or missing API key.
- `404` — The payout does not exist, belongs to another organization, or belongs to a different mode than the API key.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)