Link accounts to your client id

Returns the state of the link between an account and your client_id. Until the link is COMPLETED, Movements and Position return 403 for that account.

Look up a link by a single account number, or list every link for a holder's DNI.

Linking is automatic

You no longer link accounts yourself. Allaria creates the link when an account you opened becomes operational (CREACION_FINALIZADA) and completes it in the background, retrying on failure. These endpoints only let you check how it is going.

Check by account number

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

Returns the link for one account.

Request

Headers

Field	Type	Required	Description
Authorization	string	Yes	Access token in Bearer ACCESS_TOKEN format

Path Parameters

Field	Type	Required	Description
accountNumber	integer	Yes	The comitente of the account. Digits only. See Account identifiers.

Not applicable: Query Parameters, Body.

Response

2XX Success

Status: 200 OK

Field	Type	Description
account_number	number	The comitente you queried.
state	string	Current state of the link. See the table below.
linked_at	string or null	ISO 8601 timestamp of when the link was completed. null until state is COMPLETED.

State	Meaning
PENDING	Created, waiting to be picked up.
DISPATCHED	Picked up, about to be processed.
PROCESSING	Being linked right now.
COMPLETED	Done — your credentials can read the account.
STUCK	Processing stalled. Allaria retries it automatically.
FAILED	Retries exhausted. Contact integraciones@allaria.com.ar with the account number.

A failed attempt goes back to PENDING and is retried, so PENDING can appear again after a failure. Poll every few minutes; a link normally completes shortly after the account becomes operational.

Error Codes

Status	Description
401	Unauthorized — invalid or missing access token
404	Not Found — there is no link for that account number under your credentials. The account may not be operational yet, or was not opened by you. Body: {"message": "No linking was found for the given account number."}

Code Example

cURL

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

JavaScript

const response = await fetch('https://b2b.allaria.cloud/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.cloud/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.cloud/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"
}

Check by document

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

Returns every link for a holder's DNI. A single DNI can own several accounts, so the response is a list — one entry per account.

Request

Headers

Field	Type	Required	Description
Authorization	string	Yes	Access token in Bearer ACCESS_TOKEN format

Path Parameters

Field	Type	Required	Description
document	integer	Yes	The account holder's DNI. Digits only.

Not applicable: Query Parameters, Body.

Response

2XX Success

Status: 200 OK

A list with one entry per account linked to that DNI. When the DNI has no linked accounts under your credentials, the list is empty ([]).

Field	Type	Description
account_number	number	The comitente of the linked account.
state	string	Current state of the link. See the state table above.
linked_at	string or null	ISO 8601 timestamp of when the link was completed. null until state is COMPLETED.

Error Codes

Status	Description
401	Unauthorized — invalid or missing access token

Code Example

cURL

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

JavaScript

const response = await fetch('https://b2b.allaria.cloud/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.cloud/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.cloud/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"
  }
]