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

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

account_id
string
requerido

Unique identifier of the account.

Parámetros de consulta

direction
enum<string>

Direction of the movements to return. One of inbound (money entered the account) or outbound (money left the account).

Opciones disponibles:
inbound,
outbound
since
string<date-time>

Lower bound for the transaction date. Returns movements with a transaction_date on or after this ISO 8601 datetime in UTC.

Ejemplo:

"2026-01-01T00:00:00Z"

until
string<date-time>

Upper bound for the transaction date. Returns movements with a transaction_date on or before this ISO 8601 datetime in UTC.

Ejemplo:

"2026-03-31T23:59:59Z"

resource_id
string

Identifier of the resource that originated the movement. Returns movements whose resource_id matches, such as a specific transfer.

Ejemplo:

"tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0"

starting_after
string

Cursor that fetches the next page of movements. Use the ID of the last movement from the current page.

Ejemplo:

"mov_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

ending_before
string

Cursor that fetches the previous page of movements. Use the ID of the first movement from the current page.

Ejemplo:

"mov_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

Maximum number of movements to return per page. Ranges from 1 to 300. Defaults to 30.

Ejemplo:

50

Respuesta

List of movements for the account.

id
string
requerido

Unique identifier of the movement.

Ejemplo:

"mov_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
requerido

Type of the object. Always movement.

account_id
string
requerido

Identifier of the account the movement belongs to.

Ejemplo:

"acc_2rN1bQ8xHvK3mWpYzLd7TfGcRsE"

amount
integer
requerido

Amount of the movement, in the smallest unit of the currency. Use the direction field to tell whether money entered or left the account.

Ejemplo:

50000

balance
integer
requerido

Account balance right after the movement, in the smallest unit of the currency.

Ejemplo:

1050000

currency
enum<string>
requerido

Currency of the movement. One of CLP, MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"MXN"

direction
enum<string>
requerido

Whether money entered (inbound) or left (outbound) the account.

Opciones disponibles:
inbound,
outbound
Ejemplo:

"inbound"

mode
enum<string>
requerido

Whether the movement is live or test data.

Opciones disponibles:
live,
test
Ejemplo:

"test"

resource_id
string | null
requerido

Identifier of the resource that originated the movement, for example, a transfer. null when no resource originated the movement.

Ejemplo:

"tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0"

return_pair_id
string | null
requerido

Identifier of the other movement in a reversal pair, set on both the reversed movement and the movement that reverses it (for example, a transfer_return). null when the movement is not part of a reversal pair.

Ejemplo:

null

transaction_date
string<date-time>
requerido

Date and time Fintoc recorded the movement in the account, as an ISO 8601 datetime in UTC.

Ejemplo:

"2026-03-01T12:00:00.000Z"

type
enum<string>
requerido

Kind of movement. One of transfer, transfer_return (the reversal of a previous transfer), fee, check, compensation, or other.

Opciones disponibles:
transfer,
transfer_return,
fee,
check,
compensation,
other
Ejemplo:

"transfer"