Caja de Valores catalogues

Read-only lookups for the fields validated against Caja de Valores rather than Esco. They return { id, name, code } — and unlike the Esco catalogues, which of the two you send depends on the field.

[
  { "id": 1, "name": "Argentina", "code": "1" },
  { "id": 2, "name": "Brasil", "code": "3" }
]

Field	Type	Description
id	integer	Internal row identifier. Not used in account-opening bodies
name	string	Human-readable name. Sent for lugar_nacimiento
code	string	Caja de Valores code. Sent for localidad

name or code — the two are not interchangeable

lugar_nacimiento is validated against paises-cv.name, so you send "Argentina". localidad is validated against localidades-cv.code, so you send the code, not the locality name. Getting these the wrong way round is the most common 422 on this page's fields.

The codes here are also not the Esco country codes — see the warning on Esco catalogues.

The endpoints

Endpoint	Feeds this field	Value to send
GET/v1/aperturas/paises-cv	lugar_nacimiento	name
GET/v1/aperturas/localidades-cv	localidad	code
GET/v1/aperturas/localidades-ext-cv	Localities outside Argentina	code

localidades-cv rows also carry an esco field — the equivalent Esco locality — which Allaria uses internally to translate the value. You do not send it.

Request

Headers

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

Not applicable: Path Parameters, Query Parameters, Body.

Response

2XX Success

See the shape at the top of this page.

Error Codes

Status	Description
401	Unauthorized — invalid or missing access token
403	Forbidden — your credentials are not authorized for Aperturas
500	Internal Server Error

Code Example

Every endpoint on this page takes the same request. Substitute the path.

cURL

curl -X GET "https://b2b.allaria.cloud/v1/aperturas/paises-cv" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/paises-cv', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const paises = await response.json();

Python

import requests
response = requests.get(
  'https://b2b.allaria.cloud/v1/aperturas/paises-cv',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
paises = response.json()

Node.js

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.cloud/v1/aperturas/paises-cv', {
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
const paises = response.data;

Caching

These lists are stored at Allaria and change rarely. Cache them on your side rather than calling them once per account.