Obtener cuenta

Retorna los datos de una cuenta de un cliente.

GET/v1/accounts/{cvu}

Request

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

No aplica: Query Parameters, Body.

Response

2XX Éxito

Status: 200 OK

Retorna un objeto AccountDTO.

Campos del objeto AccountDTO

Campo	Tipo	Descripción
accountId	integer	Identificador de la cuenta
cuit	string	CUIT del titular de la cuenta
cvu	string	CVU de la cuenta
name	string	Nombre del titular 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
500	Internal Server Error — error interno del servidor

Estructura del error (ErrorResponse):

{
  "timestamp": "2026-06-04T10:30:00Z",
  "status": 404,
  "error": "Not Found",
  "message": "Account not found",
  "code": "ACCOUNT_NOT_FOUND",
  "path": "/v1/accounts/0000031000010000000001"
}

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

curl -X GET "https://b2b.allaria.cloud/v1/accounts/0000031000010000000001" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/accounts/0000031000010000000001', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN'
  }
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
  'https://b2b.allaria.cloud/v1/accounts/0000031000010000000001',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN'
  }
)

data = response.json()
print(data)

Node.js

const axios = require('axios');

const response = await axios.get('https://b2b.allaria.cloud/v1/accounts/0000031000010000000001', {
  headers: {
    Authorization: 'Bearer ACCESS_TOKEN'
  }
});

console.log(response.data);

2XX Éxito

{
  "accountId": 12345,
  "cuit": "20304050607",
  "cvu": "0000031000010000000001",
  "name": "Juan Pérez"
}