Skip to main content
GET
Listar movimientos de una cuenta
Los movimientos de una cuenta bancaria tal como quedaron en la última lectura del banco, los más nuevos primero. El GET nunca toca al banco.
Necesitas banking:read explícito en la API key (ver Introducción). Una cuenta de otra empresa responde 404.

Filtros

Un valor inválido responde 400 con code: parameter_invalid y param. page y page_size (tope 200) paginan; ?fields= recorta los campos.

El dato crudo

  • amount nunca lleva signo; direction dice si entró o salió. Es el mismo contrato de Fintoc v2, así que si ya integraste un agregador no cambias nada. Entero en CLP; con decimales en otras monedas.
  • status: pending mientras el banco no lo contabiliza, posted cuando sí, removed si el banco lo revirtió. posted_movement_id enlazará una pendiente con la posteada que la reemplazó cuando llegue la sincronización por cursor; hoy viene null, igual que balance_after.
  • description es la glosa tal cual la entrega el banco. No la normalizamos.

Lo que Tupana agrega

  • counterparty: la contraparte resuelta. Un agregador entrega la glosa; Tupana además identifica el RUT, la razón social, el banco y la cuenta enmascarada de quien pagó o cobró, con el dato estructurado del banco o, si no viene, con lo que dice la glosa. null cuando no hay nada que resolver. El número de cuenta de la contraparte completo nunca sale.
  • category: qué es el dinero según la clasificación de Tupana: customer_payment, supplier_payment, payroll, taxes, bank_fees, internal_transfer, card_settlement. null si todavía no se clasificó o no se identificó.
Acá no hay nada de documentos tributarios ni de conciliación: ni facturas asociadas, ni estado contable. La API bancaria habla de dinero.

Authorizations

Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Path Parameters

account_id
string
required
Example:

"bacc_7Hk2938475610293"

Query Parameters

since
string<date>

Desde esta transaction_date, inclusive.

until
string<date>

Hasta esta transaction_date, inclusive.

direction
enum<string>
Available options:
inbound,
outbound
status
enum<string>
Available options:
pending,
posted
min_amount
number

Sobre el monto sin signo.

max_amount
number

Sobre el monto sin signo.

page
integer
default:1
page_size
integer
default:50
Required range: x <= 200
fields
string

Response

Movimientos

data
object[]
meta
object