Saltar al contenido principal
GET
List movements
v1 · Base URL https://api.fintoc.com/v1
Uso de los parámetros per_page y pageSi te faltan movimientos en nuestra API, intenta ajustar el parámetro per_page para obtener más movimientos en tus solicitudes. Recuerda que el valor por defecto de este parámetro es 30 y el valor máximo es 300.Además, si tienes más movimientos que el valor de per_page, intenta iterar a través de nuestras páginas usando el parámetro page. Así puedes revisar todas las páginas de movimientos almacenadas.

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

The id of the account that holds the movements to list.

Parámetros de consulta

The link_token of the link that holds the account, obtained when you exchanged the link.

Ejemplo:

"link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX"

since
string<date>

ISO 8601 date. If present, Fintoc returns only movements with post_date on or after since.

until
string<date>

ISO 8601 date. If present, Fintoc returns only movements with post_date on or before until.

updated_since
string<date>

ISO 8601 date. If present, Fintoc returns only movements created or updated after updated_since.

per_page
string

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

page
integer<int32>

Page number to retrieve. Starts at 1.

confirmed_only
boolean

Whether to return only confirmed movements. Defaults to true. When false, the endpoint also returns movements with status processing, reversed, and manually_reversed.

Respuesta

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

id
string
requerido

Unique identifier of the movement.

Ejemplo:

"mov_BO381oEATXonG6bj"

object
any
requerido

Type of the object. Always movement.

amount
integer
requerido

Amount of the movement, in the smallest unit of the currency (CLP has no decimals, so the amount is in pesos). Negative for outflows.

Ejemplo:

-1717

comment
string | null
requerido

Comment the sender attached to the movement, as registered at the institution.

Ejemplo:

"Pago arriendo"

currency
string
requerido

Three-letter ISO 4217 currency code of the movement.

Pattern: ^[A-Z]{3}$
Ejemplo:

"CLP"

description
string
requerido

Description of the movement, as registered at the institution.

Ejemplo:

"Cargo Seguro Proteccion Bancaria"

document_number
string | null
requerido

Number of the document associated to the movement (for example, the check number). null if the movement has no associated document.

Ejemplo:

"4527230"

pending
boolean
requerido

Whether the movement is pending consolidation by the institution.

Ejemplo:

false

post_date
string<date-time>
requerido

ISO 8601 timestamp of when the institution consolidated the movement.

Ejemplo:

"2020-04-06T00:00:00.000Z"

recipient_account
null · object · null
requerido

Account that received the transfer. Only present for transfers; null for every other movement type.

reference_id
string | null
requerido

Identifier of the movement at the institution: the transfer_id if present, otherwise the document_number.

Ejemplo:

"123740123"

sender_account
null · object · null
requerido

Account that sent the transfer. Only present for transfers; null for every other movement type.

status
enum<string>
requerido

Status of the movement. processing means Fintoc is verifying whether the institution duplicated or reversed the movement.

Opciones disponibles:
confirmed,
reversed,
processing,
manually_reversed
Ejemplo:

"confirmed"

transaction_date
string<date-time> | null
requerido

ISO 8601 timestamp of when the movement happened, with time precision. null when the institution only reports the post_date.

Ejemplo:

"2020-04-04T02:19:23.000Z"

transfer_id
string | null
requerido

Identifier of the transfer at the institution. null if the movement is not a transfer.

Ejemplo:

"123740123"

type
enum<string>
requerido

Type of the movement.

Opciones disponibles:
check,
transfer,
other
Ejemplo:

"transfer"