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. El accountId es el walletId que devuelve la consulta de cuentas. 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.

Propiedad	Valor
Método	GET
Path	/b2b/movements/{accountId}
Autenticación	Authorization: <access_token>
Content-Type respuesta	application/json
Cuerpo de la petición	No aplica (GET)
Respuesta	200 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.

Ambiente	URL completa del endpoint
Producción	https://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

Sin prefijo Bearer

El token va directo en el header Authorization, sin el prefijo Bearer.

Parámetros

Path

CampoTipoReq.Descripción

accountId

integer

req

Identificador de la cuenta cuyos movimientos se quieren consultar. Es el walletId que devuelve la consulta de cuentas GET /b2b/accounts. Debe pertenecer al cliente autenticado. ej: 123456

Query

CampoTipoReq.Descripción

dateFrom

string (date)

opt

Fecha inicial del filtro en formato yyyy-MM-dd (inclusive). ej: 2026-01-01

dateTo

string (date)

opt

Fecha final del filtro en formato yyyy-MM-dd (inclusive). Debe ser mayor o igual a dateFrom. ej: 2026-01-31

page

integer

opt

Página a consultar (1-based, mínimo 1). Default: 1. ej: 2

Query params opcionales

Los tres parámetros son opcionales. GET /b2b/movements/{accountId} sin query params devuelve la primera página sin filtro de fechas.

Headers

CampoTipoReq.Descripción

Authorization

string

req

Token de acceso. Se envía directo, sin prefijo Bearer. ej: <access_token>

Ejemplo de petición

cURL

Copiar código

HTTP

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.

Campos opcionales

Los campos con valor nulo se omiten de la respuesta. Un elemento real puede traer solo un subconjunto de los campos de la tabla — tu integración debe tolerar que cualquier campo opcional no esté presente.

¿Necesitas más detalle de un movimiento?

El listado no incluye el beneficiario ni el desglose completo de cada movimiento. Con el id de un elemento de movements puedes consultar los montos, la tasa, los costos, el propósito y el beneficiario en Detalle de movimientos, pasando el productType del elemento.

Un movimiento de fee trae como id el identificador del fee en el core bancario, no un identificador propio de este listado. La transacción que originó uno o más fees lista esos mismos identificadores en associatedFees. Un fee no se puede consultar en el detalle porque no trae productType.

Esquema

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_OUTP2PPAY_IN

ej: PAY_OUT

subCategory

string (enum)

Subcategoría del movimiento.

REMITTANCEPAYMENTEXCHANGEBANK_TRANSFER

ej: REMITTANCE

productType

string (enum)

Identifica el producto del movimiento y es el valor que se pasa al detalle en GET /b2b/movements/{accountId}/{movementId}. Se omite en los fees y en los movimientos históricos que no traen subcategoría. Los depósitos por transferencia bancaria (category PAY_IN y subCategory BANK_TRANSFER) traen PAYIN. Los pagos recibidos por Cobros de terceros vienen sin productType, así que no se pueden consultar en el detalle.

REMITTANCEP2PEXCHANGEPAYIN

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

associatedFees

integer[]

Identificadores de los fees que originó el movimiento. Se omite si el movimiento no originó ninguno. ej: [101, 102]

Ejemplo de respuesta

Copiar código

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.