Transferencias de cuenta
Retorna el listado de transferencias de una cuenta de un cliente dentro de un rango de fechas.
GET
/v1/accounts/{cvu}/transfersRequest
Headers
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
Authorization | string | Sí | Token de acceso en formato Bearer ACCESS_TOKEN |
Path Parameters
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
cvu | string | Sí | CVU de la cuenta |
Query Parameters
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
from | string (date) | Sí | Fecha de inicio del rango en formato YYYY-MM-DD |
to | string (date) | No | Fecha de fin del rango en formato YYYY-MM-DD. Si se omite, no se aplica límite superior |
No aplica: Body.
Response
2XX Éxito
Status: 200 OK
Retorna un array de objetos TransferDTO.
Campos del objeto TransferDTO
| Campo | Tipo | Descripción |
|---|---|---|
id | integer | Identificador de la transferencia |
amount | number | Monto de la transferencia |
currency | string | Moneda de la transferencia |
description | string | Descripción de la transferencia |
concept | string | Concepto de la transferencia |
creationDateTime | string (date-time) | Fecha y hora de creación (ISO 8601) |
processedDateTime | string (date-time) | Fecha y hora de procesamiento (ISO 8601) |
originAccount | object | Cuenta de origen. Ver TransferAccountDTO |
destinationAccount | object | Cuenta de destino. Ver TransferAccountDTO |
Campos del objeto TransferAccountDTO
| Campo | Tipo | Descripción |
|---|---|---|
accountId | integer | Identificador de la cuenta |
name | string | Nombre del titular de la cuenta |
cuit | string | CUIT del titular de la cuenta |
cvu | string | CVU de la cuenta |
Códigos de error
| Status | Descripción |
|---|---|
401 | Unauthorized — token inválido o ausente |
403 | Forbidden — falta el rol requerido |
404 | Not Found — la cuenta no existe |
422 | Request validation error — parámetros inválidos (por ejemplo, from ausente o con formato incorrecto) |
500 | Internal Server Error — error interno del servidor |
Estructura del error (ErrorResponse):
{
"timestamp": "2026-06-04T10:30:00Z",
"status": 422,
"error": "Unprocessable Entity",
"message": "from is required",
"code": "VALIDATION_ERROR",
"path": "/v1/accounts/0000031000010000000001/transfers"
}
| Campo | Tipo | Descripción |
|---|---|---|
timestamp | string | Momento en que se produjo el error |
status | integer | Código de estado HTTP |
error | string | Nombre del error |
message | string | Mensaje descriptivo del error |
code | string | null | Código interno del error (puede ser null) |
path | string | Path del request que originó el error |
Ejemplo de código
- cURL
- JavaScript
- Python
- Node.js
curl -X GET "https://b2b.allaria.cloud/v1/accounts/0000031000010000000001/transfers?from=2026-01-01&to=2026-01-31" \
-H "Authorization: Bearer ACCESS_TOKEN"
const params = new URLSearchParams({
from: '2026-01-01',
to: '2026-01-31'
});
const response = await fetch(`https://b2b.allaria.cloud/v1/accounts/0000031000010000000001/transfers?${params}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer ACCESS_TOKEN'
}
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
'https://b2b.allaria.cloud/v1/accounts/0000031000010000000001/transfers',
headers={
'Authorization': 'Bearer ACCESS_TOKEN'
},
params={
'from': '2026-01-01',
'to': '2026-01-31'
}
)
data = response.json()
print(data)
const axios = require('axios');
const response = await axios.get('https://b2b.allaria.cloud/v1/accounts/0000031000010000000001/transfers', {
headers: {
Authorization: 'Bearer ACCESS_TOKEN'
},
params: {
from: '2026-01-01',
to: '2026-01-31'
}
});
console.log(response.data);
2XX Éxito
[
{
"id": 9876,
"amount": 50000.00,
"currency": "ARS",
"description": "Transferencia a proveedor",
"concept": "VAR",
"creationDateTime": "2026-01-15T10:30:00Z",
"processedDateTime": "2026-01-15T10:30:05Z",
"originAccount": {
"accountId": 12345,
"name": "Juan Pérez",
"cuit": "20304050607",
"cvu": "0000031000010000000001"
},
"destinationAccount": {
"accountId": 67890,
"name": "Proveedor S.A.",
"cuit": "30712345678",
"cvu": "0000031000010000000002"
}
}
]