Obtener cuentas cuotapartistas por documento

Devuelve todas las cuentas cuotapartistas en las que una persona es titular, buscadas por número de DNI, sin importar quién creó la cuenta.

GET/v1/aperturas/unit-holder/by-document/{document_number}

Requiere permiso de lectura

Esta consulta cruza cuentas de distintos creadores, por lo que necesita un permiso de lectura que Allaria otorga por separado. Sin él la llamada falla con 403.

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Access token con formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
document_number	string	Sí	Número de DNI del titular.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Status: 200 OK

Campo	Tipo	Descripción
document_number	string	El número consultado.
accounts	array	Cuentas ordenadas por creación. Cada ítem tiene la misma forma que account en Obtener cuenta cuotapartista (abreviado acá).

Error Codes

Status	Descripción
401	Unauthorized — access token inválido o ausente
403	Forbidden — sin permiso de lectura
404	Not Found — la persona no es titular de ninguna cuenta

Code Example

cURL

curl -X GET "https://b2b.allaria.cloud/v1/aperturas/unit-holder/by-document/30123474" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/unit-holder/by-document/30123474', {
  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/aperturas/unit-holder/by-document/30123474',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
print(response.json())

Node.js

const axios = require('axios');
const response = await axios.get(
  'https://b2b.allaria.cloud/v1/aperturas/unit-holder/by-document/30123474',
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Éxito

{
  "document_number": "30123474",
  "accounts": [
    {
      "tax_id": "30712345833",
      "legal_entity_name": "EMPRESA PRUEBA SA",
      "state": "Operativo",
      "creation_state": "CREATED",
      "unit_holder_number": 123456,
      "persons": []
    }
  ]
}