Vincular cuentas a tu client id

Devuelve el estado de la vinculación entre una cuenta y tu client_id. Hasta que la vinculación esté COMPLETED, Movimientos y Posición devuelven 403 para esa cuenta.

Consultá una vinculación por un único número de cuenta, o listá todas las vinculaciones del DNI de un titular.

La vinculación es automática

Ya no vinculás las cuentas vos. Allaria crea la vinculación cuando una cuenta que abriste queda operativa (CREACION_FINALIZADA) y la completa en segundo plano, reintentando ante fallas. Estos endpoints solo te permiten consultar cómo va.

Consultar por número de cuenta

GET/v1/aperturas/link-accounts/by-account-number/{accountNumber}

Devuelve la vinculación de una cuenta.

Request

Headers

Field	Type	Required	Description
Authorization	string	Sí	Access token con formato Bearer ACCESS_TOKEN

Path Parameters

Field	Type	Required	Description
accountNumber	integer	Sí	El comitente de la cuenta. Solo dígitos. Ver Identificadores de cuenta.

Not applicable: Query Parameters, Body.

Response

2XX Success

Status: 200 OK

Field	Type	Description
account_number	number	El comitente consultado.
state	string	Estado actual de la vinculación. Ver la tabla de abajo.
linked_at	string or null	Fecha y hora ISO 8601 en que se completó la vinculación. null hasta que state sea COMPLETED.

State	Significado
PENDING	Creada, esperando ser tomada.
DISPATCHED	Tomada, a punto de procesarse.
PROCESSING	Vinculándose en este momento.
COMPLETED	Lista — tus credenciales ya pueden leer la cuenta.
STUCK	El procesamiento se frenó. Allaria lo reintenta automáticamente.
FAILED	Se agotaron los reintentos. Escribinos a integraciones@allaria.com.ar con el número de cuenta.

Un intento fallido vuelve a PENDING y se reintenta, así que PENDING puede reaparecer tras una falla. Consultá cada algunos minutos; normalmente la vinculación se completa poco después de que la cuenta queda operativa.

Error Codes

Status	Description
401	Unauthorized — access token inválido o ausente
404	Not Found — no hay vinculación para ese número de cuenta con tus credenciales. Puede que la cuenta todavía no esté operativa o que no la hayas abierto vos. Body: {"message": "No linking was found for the given account number."}

Code Example

cURL

curl -X GET "https://b2b.allaria.dev/v1/aperturas/link-accounts/by-account-number/400000123" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/aperturas/link-accounts/by-account-number/400000123', {
  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/link-accounts/by-account-number/400000123',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
data = response.json()
print(data)

Node.js

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

2XX Success

{
  "account_number": 400000123,
  "state": "COMPLETED",
  "linked_at": "2026-10-13T14:36:38+00:00"
}

Consultar por documento

GET/v1/aperturas/link-accounts/by-document/{document}

Devuelve todas las vinculaciones del DNI de un titular. Un mismo DNI puede tener varias cuentas, así que la respuesta es una lista — una entrada por cuenta.

Request

Headers

Field	Type	Required	Description
Authorization	string	Sí	Access token con formato Bearer ACCESS_TOKEN

Path Parameters

Field	Type	Required	Description
document	integer	Sí	El DNI del titular de la cuenta. Solo dígitos.

Not applicable: Query Parameters, Body.

Response

2XX Success

Status: 200 OK

Una lista con una entrada por cada cuenta vinculada a ese DNI. Si el DNI no tiene cuentas vinculadas con tus credenciales, la lista viene vacía ([]).

Field	Type	Description
account_number	number	El comitente de la cuenta vinculada.
state	string	Estado actual de la vinculación. Ver la tabla de estados de arriba.
linked_at	string or null	Fecha y hora ISO 8601 en que se completó la vinculación. null hasta que state sea COMPLETED.

Error Codes

Status	Description
401	Unauthorized — access token inválido o ausente

Code Example

cURL

curl -X GET "https://b2b.allaria.dev/v1/aperturas/link-accounts/by-document/42301048" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/aperturas/link-accounts/by-document/42301048', {
  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/link-accounts/by-document/42301048',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
data = response.json()
print(data)

Node.js

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

2XX Success

[
  {
    "account_number": 40000001,
    "state": "COMPLETED",
    "linked_at": "2026-10-14T17:36:54+00:00"
  },
  {
    "account_number": 40000000,
    "state": "COMPLETED",
    "linked_at": "2026-10-14T17:32:05+00:00"
  }
]