Saltar al contenido principal
GET
List payouts
v1 · Base URL https://api.fintoc.com/v1

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

since
string<date>

ISO 8601 date. Returns only payouts created on or after this date.

until
string<date>

ISO 8601 date. Returns only payouts created on or before this date.

status
enum<string>

Returns only payouts with this status. One of in_progress, succeeded, canceled, or returned. See the payout status attribute for what each value means.

Opciones disponibles:
in_progress,
succeeded,
canceled,
returned
page
integer<int32>

Page number to retrieve. Starts at 1.

per_page
integer<int32>

Number of payouts per page. Defaults to 30. The maximum is 300.

Respuesta

Paginated list of payouts. The Link and X-Total-Count headers carry the pagination information.

id
string
requerido

Unique identifier of the payout.

Ejemplo:

"po_BO381oEATXonG6bj"

object
any
requerido

Type of the object. Always payout.

amount
integer
requerido

Value disbursed, in the smallest unit of the currency. CLP has no decimals, so amounts are in pesos. MXN amounts are in centavos.

Ejemplo:

550000

created_at
string<date-time>
requerido

ISO 8601 timestamp, in UTC, of when Fintoc created the payout.

Ejemplo:

"2026-03-04T14:10:00Z"

currency
string
requerido

Three-letter ISO 4217 currency code, returned in uppercase.

Ejemplo:

"CLP"

mode
enum<string>
requerido

Mode of the object. live objects use real institution data, test objects use fake data for integration testing.

Opciones disponibles:
test,
live
Ejemplo:

"live"

recipient_account
object
requerido

Bank account that receives the payout.

status
enum<string>
requerido

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).

Opciones disponibles:
in_progress,
succeeded,
canceled,
returned
Ejemplo:

"succeeded"

succeeded_at
string<date-time> | null
requerido

ISO 8601 timestamp, in UTC, of when the payout succeeded. null until the payout succeeds.

Ejemplo:

"2026-03-05T12:00:00Z"

updated_at
string<date-time>
requerido

ISO 8601 timestamp, in UTC, of when Fintoc last updated the payout.

Ejemplo:

"2026-03-05T12:00:00Z"