Unit holder catalogues

Returns the accepted values for the catalogue fields of Create unit holder account. Send each value exactly as returned — they are Spanish text, not codes.

Endpoint	Returns
GET/v1/aperturas/unit-holder/catalogs	Every catalogue at once.
GET/v1/aperturas/unit-holder/catalogs/{catalog}	One catalogue.

Both take the same request, so this page documents it once. Available to credentials that can create accounts or hold the reader permission.

Catalogue	Feeds the field	Value format
gender	persons[].gender	String: Masculino, Femenino
taxpayer_type	account.taxpayer_type, persons[].taxpayer_type	String, e.g. Responsable inscripto, Consumidor final
country	persons[].address.country	String, e.g. Argentina
nationality	persons[].nationality	Same list as country
activity	persons[].activity	String, e.g. Docente
province	persons[].address.province	Object { "province", "country" } — send province together with the matching country

Request

Headers

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

Path Parameters

Field	Type	Required	Description
catalog	string	Only on /catalogs/{catalog}	One of gender, province, country, nationality, activity, taxpayer_type.

Not applicable: Query Parameters, Body.

Response

2XX Success

Status: 200 OK

/catalogs/{catalog} returns one key, named after the catalogue. /catalogs returns all six keys, each with its list.

Error Codes

Status	Description
401	Unauthorized — invalid or missing access token
403	Forbidden — your credentials can neither create accounts nor read them
404	Not Found — unknown catalogue name

Code Example

cURL

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

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/aperturas/unit-holder/catalogs/province', {
  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/catalogs/province',
  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/catalogs/province',
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Success

{
  "province": [
    { "province": "Neuquén", "country": "Argentina" },
    { "province": "Buenos Aires", "country": "Argentina" }
  ]
}