Ir al contenido
Global66 Developers

Consulta de movimientos

GET/b2b/movements/{accountId}

Devuelve el historial paginado de movimientos de una cuenta perteneciente al cliente autenticado. Endpoint de solo lectura del servicio business-api.

Esta guía explica cómo consumir el endpoint una vez que ya cuentas con un token de acceso válido. La obtención del token está cubierta en la documentación de autenticación y no se repite aquí — este documento asume que ya tienes un access_token vigente.

Resumen

Devuelve los movimientos (transacciones) de la cuenta indicada en accountId, para el cliente identificado, junto con datos de paginación. Cada elemento es una representación plana del movimiento (importe, estado, tipo, fecha, categoría, divisas, tasas, etc.). La lista puede venir vacía.

Puedes filtrar por rango de fechas con dateFrom y dateTo (formato yyyy-MM-dd, ambos inclusive). Los filtros son opcionales e independientes:

  • Solo dateFrom → movimientos desde esa fecha en adelante.
  • Solo dateTo → todo hasta esa fecha.
  • Sin fechas → todos los movimientos sin filtro.

La respuesta viene paginada en bloques de 50 movimientos. Para consultar las páginas siguientes, incrementa el parámetro page (page=2, page=3, …) manteniendo los mismos filtros, hasta llegar a totalPages. totalElements indica el total de movimientos de la consulta sin importar la paginación.

PropiedadValor
MétodoGET
Path/b2b/movements/{accountId}
AutenticaciónAuthorization: <access_token>
Content-Type respuestaapplication/json
Cuerpo de la peticiónNo aplica (GET)
Respuesta200 OK con objeto paginado (el array movements puede venir vacío)

URL base

El path del endpoint es siempre /business-api/b2b/movements/{accountId}. Solo cambia el host según el ambiente.

AmbienteURL completa del endpoint
Producciónhttps://api.global66.com/business-api/b2b/movements/{accountId}

Autenticación

El endpoint está protegido por el API Gateway con un autorizador basado en el token del cliente. Como integrador solo debes enviar el header de autorización con tu token de acceso:

Copiar código

Parámetros

Path

CampoTipoDescripción
accountId
integer
Identificador de la cuenta cuyos movimientos se quieren consultar. Debe pertenecer al cliente autenticado. ej: 123456

Query

CampoTipoDescripción
dateFrom
string (date)
Fecha inicial del filtro en formato yyyy-MM-dd (inclusive). ej: 2026-01-01
dateTo
string (date)
Fecha final del filtro en formato yyyy-MM-dd (inclusive). Debe ser mayor o igual a dateFrom. ej: 2026-01-31
page
integer
Página a consultar (1-based, mínimo 1). Default: 1. ej: 2

Headers

CampoTipoDescripción
Authorization
string
Token de acceso. Se envía directo, sin prefijo Bearer. ej: <access_token>

Ejemplo de petición

Copiar código

Respuesta 200 OK

La respuesta es un objeto con paginación que contiene un array movements con los MovementRecord de la página consultada. El array puede venir vacío ([]) si la cuenta no tiene movimientos en el rango consultado.

Envelope de paginación

CampoTipoDescripción
totalElements
integer
Total de movimientos de la consulta, sin importar la paginación. ej: 103
totalPages
integer
Total de páginas disponibles para la consulta. ej: 3
page
integer
Página actual (1-based). ej: 1
size
integer
Tamaño de página (50 movimientos). ej: 50
movements
MovementRecord[]
Movimientos de la página consultada.

MovementRecord

CampoTipoDescripción
id
integer
Identificador único del movimiento. ej: 1
amount
decimal
Importe del movimiento. ej: 1500
status
string (enum)
Estado del movimiento.
PAIDACCEPTED_BY_INITIATORGMF_FEEFEE_WITHDRAWALFEE_VAT_TAX
ej: PAID
comment
string
Comentario o nota asociada al movimiento. ej: Pago a proveedor
type
string (enum)
Tipo de movimiento.
AUTOMATIC_TX_FUNDBANK_TRANSFERP2P_PAYMENTEXCHANGEGMF_FEEFEE_WITHDRAWALFEE_VAT_TAX
ej: AUTOMATIC_TX_FUND
date
string (date-time)
Fecha del movimiento en formato ISO-8601 (yyyy-MM-ddTHH:mm:ss, UTC). ej: 2026-01-15T14:30:00
destinataryName
string
Nombre del destinatario. ej: Juan Pérez
destinataryCountryCode
string
Código de país del destinatario (ISO 3166). ej: CL
nameCommerce
string
Nombre del comercio. ej: Global66
typeMovement
string (enum)
Clasificación del movimiento.
WITHDRAWALDEPOSIT
ej: WITHDRAWAL
isFavorite
boolean
Indica si el movimiento está marcado como favorito. ej: false
category
string (enum)
Categoría del movimiento.
PAY_OUTP2P
ej: PAY_OUT
subCategory
string (enum)
Subcategoría del movimiento.
REMITTANCEPAYMENTEXCHANGE
ej: REMITTANCE
currencyCode
string
Divisa del importe (ISO 4217). ej: USD
destinataryCurrencyCode
string
Divisa del destinatario (ISO 4217). ej: CLP
exchangeRate
string
Tasa de cambio aplicada. ej: 3353.159912109375
totalBalance
decimal
Saldo total de la cuenta tras el movimiento. ej: 8500
originCurrency
string
Divisa de origen (ISO 4217). ej: USD
originAmount
decimal
Importe en la divisa de origen. ej: 1500
destinationAmount
decimal
Importe en la divisa de destino. ej: 1425750
destinationCurrency
string
Divisa de destino (ISO 4217). ej: CLP
fee
decimal
Comisión aplicada al movimiento. ej: 5
originRate
decimal
Tasa de la divisa de origen. ej: 1
greaterToLesserValueRate
decimal
Tasa de conversión (de mayor a menor valor). ej: 950.5
destinationAmountUSD
decimal
Importe de destino expresado en USD. ej: 1500
originAmountUSD
decimal
Importe de origen expresado en USD. ej: 1500
discountAmount
decimal
Monto de descuento aplicado. ej: 0
rejectedBy
string
Quién rechazó el movimiento (si aplica).
rejectedReason
string
Razón del rechazo (si aplica).

Errores

CampoTipoDescripción
400
BAD_REQUEST · 000400
La petición no contiene los datos mínimos para resolver la cuenta, alguna fecha tiene formato inválido, dateFrom es mayor que dateTo, o page es menor que 1.
404
BANK_ACCOUNT_NOT_FOUND · 016400
No existe una cuenta activa para el accountId y el cliente indicados.