> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a payout > Retrieves a payout by its `id`. Only payouts matching the `live` or `test` mode of the API key are visible. **`v1`** ยท Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json GET /payouts/{id} openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /payouts/{id}: get: tags: - Payouts summary: Get a payout description: >- Retrieves a payout by its `id`. Only payouts matching the `live` or `test` mode of the API key are visible. operationId: payouts-get parameters: - name: id in: path description: Unique identifier of the payout to retrieve. required: true schema: type: string responses: '200': description: The payout. content: application/json: examples: payout: value: id: po_BO381oEATXonG6bj object: payout amount: 550000 created_at: '2026-03-04T14:10:00Z' currency: CLP mode: live recipient_account: holder_id: '111111111' institution_id: cl_banco_estado number: '987654321' type: checking_account status: succeeded succeeded_at: '2026-03-05T12:00:00Z' updated_at: '2026-03-05T12:00:00Z' schema: $ref: '#/components/schemas/payouts_payout' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '404': description: >- The payout does not exist, belongs to another organization, or belongs to a different mode than the API key. content: application/json: examples: payout_not_found: value: error: type: invalid_request_error code: missing_resource param: id message: 'No such payouts/payout: po_BO381oEATXonG6bj' doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: payouts_payout: type: object description: >- 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. properties: id: type: string description: Unique identifier of the payout. example: po_BO381oEATXonG6bj object: const: payout description: Type of the object. Always `payout`. amount: type: integer description: >- Value disbursed, in the smallest unit of the currency. CLP has no decimals, so amounts are in pesos. MXN amounts are in centavos. example: 550000 created_at: type: string format: date-time description: ISO 8601 timestamp, in UTC, of when Fintoc created the payout. example: '2026-03-04T14:10:00Z' currency: type: string description: Three-letter ISO 4217 currency code, returned in uppercase. example: CLP mode: $ref: '#/components/schemas/mode' recipient_account: $ref: '#/components/schemas/payouts_recipient_account' status: type: string enum: - in_progress - succeeded - canceled - returned description: >- 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). example: succeeded succeeded_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp, in UTC, of when the payout succeeded. `null` until the payout succeeds. example: '2026-03-05T12:00:00Z' updated_at: type: string format: date-time description: ISO 8601 timestamp, in UTC, of when Fintoc last updated the payout. example: '2026-03-05T12:00:00Z' required: - id - object - amount - created_at - currency - mode - recipient_account - status - succeeded_at - updated_at error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_api_key`. Not returned by every error. example: invalid_api_key doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Invalid API Key: invalid-*oken' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. `null` when the error cannot be tied to a single parameter, and not returned by every error. example: amount type: type: string description: >- Category of the error, for example `invalid_request_error`, `authentication_error`, or `api_error`. example: invalid_request_error required: - type - message mode: type: string enum: - test - live description: >- Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing. example: live payouts_recipient_account: type: object description: Bank account that receives the payout. properties: holder_id: type: string description: >- Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico). example: '111111111' institution_id: type: string description: >- Fintoc identifier of the institution that holds the account, such as `cl_banco_estado`. example: cl_banco_estado number: type: string description: >- Account number. In Mexico, an 18-digit CLABE (Clave Bancaria Estandarizada). example: '987654321' type: type: string enum: - checking_account - sight_account - rut_account - fsa_account description: >- Account subtype. One of `checking_account`, `sight_account` (Chilean cuenta vista), `rut_account` (BancoEstado CuentaRUT), or `fsa_account` (Mexican FSA account). example: checking_account required: - holder_id - institution_id - number - type securitySchemes: api_key: type: apiKey name: Authorization in: header ````