Obtener cuenta cuotapartista

Devuelve una cuenta cuotapartista por CUIT de la empresa, con sus titulares y el avance de su creación. Usalo para consultar después de Crear cuenta cuotapartista.

GET/v1/aperturas/unit-holder/accounts/{tax_id}

Podés leer las cuentas que creaste vos. Leer cualquier cuenta requiere un permiso de lectura que Allaria otorga por separado.

Request

Headers

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

Path Parameters

Campo	Tipo	Requerido	Descripción
tax_id	string	Sí	CUIT de la empresa, 11 dígitos.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Status: 200 OK

Campo	Tipo	Descripción
account.tax_id, legal_entity_name, is_reporting_entity, email, requires_joint_signature, taxpayer_type	—	Igual que lo enviado en Crear cuenta cuotapartista.
account.type	string	Tipo de cuenta. Informativo.
account.campaign	string	Nombre del grupo de PSP que Allaria te asignó. Informativo; ver PSPs internos y externos.
account.state	string	Ingresado hasta que termina la creación, luego Operativo.
account.creation_state	string	Ver estados de creación.
account.unit_holder_number	integer o null	Número de cuotapartista. null hasta que la cuenta se crea.
account.notes	array	Avisos generados al crear la cuenta. Presente con CREATED_WITH_ALERTS.
account.last_status_checked_at	string o null	Cuándo se consultó por última vez el avance de la creación.
account.errors	array	Errores del administrador del fondo, cada uno { "at", "message" }. Se conservan entre reenvíos.
account.created_at, updated_at	string	YYYY-MM-DD HH:mm:ss.
account.persons	array	Los titulares, ordenados por position. Mismos campos que el request, más position y document_type (siempre DNI).

Estados de creación

creation_state	Significado	Final
PENDING	Guardada, todavía sin encolar.	No
DISPATCHED	En cola para enviarse.	No
PROCESSING	Enviada; esperando el resultado. Se consulta cada unos 15 minutos.	No
CREATED	Creada. unit_holder_number está informado.	Sí
CREATED_WITH_ALERTS	Creada con avisos listados en notes.	Sí
ALREADY_EXISTS	La empresa ya tenía una cuenta. unit_holder_number es ese número existente.	Sí
FAILED	Rechazada. El motivo está en errors. Reenviá con los datos corregidos.	Sí
STUCK	Sin respuesta tras varios intentos. Reenviá o contactá a soporte.	Sí

Error Codes

Status	Descripción
401	Unauthorized — access token inválido o ausente
403	Forbidden — la cuenta no fue creada por vos y no tenés permiso de lectura
404	Not Found — no hay cuenta para ese CUIT

Code Example

cURL

curl -X GET "https://b2b.allaria.dev/v1/aperturas/unit-holder/accounts/30712345833" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/aperturas/unit-holder/accounts/30712345833', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const data = await response.json();
console.log(data);

Python

import requests
response = requests.get(
  'https://b2b.allaria.dev/v1/aperturas/unit-holder/accounts/30712345833',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
print(response.json())

Node.js

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

2XX Éxito

{
  "account": {
    "type": "unit_holder",
    "tax_id": "30712345833",
    "legal_entity_name": "EMPRESA PRUEBA SA",
    "is_reporting_entity": false,
    "email": "empresa@example.com",
    "requires_joint_signature": false,
    "taxpayer_type": "Responsable inscripto",
    "campaign": "EXTERNAL_PSP",
    "state": "Operativo",
    "creation_state": "CREATED",
    "unit_holder_number": 123456,
    "notes": [],
    "last_status_checked_at": "2026-10-20 10:15:00",
    "errors": [],
    "created_at": "2026-10-20 10:00:00",
    "updated_at": "2026-10-20 10:15:00",
    "persons": [
      {
        "position": 1,
        "surname": "PEREZ",
        "names": "JUAN CARLOS",
        "document_type": "DNI",
        "document_number": "30123474",
        "gender": "Masculino",
        "tax_id": "20301234741",
        "birthday": "1975-05-14",
        "is_pep": false,
        "is_reporting_entity": false,
        "email": "juan.perez@example.com",
        "nationality": "Argentina",
        "activity": "Docente",
        "taxpayer_type": "Consumidor final",
        "address": {
          "street": "Avenida Argentina",
          "street_number": "100",
          "zip_code": "8300",
          "city": "Neuquén",
          "province": "Neuquén",
          "country": "Argentina",
          "phone": "2991234567"
        }
      }
    ]
  }
}