Obtener perfil de inversión

Devuelve el perfil de inversión de un cliente, incluyendo su nivel de riesgo y los instrumentos que está autorizado a operar.

GET/v1/broker/investment-profile/{account-id}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
account-id	integer	Sí	Identificador de la cuenta.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Campo	Tipo	Descripción
legal_entity	string	Entidad legal asociada al cliente en el OMS del broker.
person_type	string	Tipo de persona. Valores típicos: FISICA (persona física), JURIDICA (persona jurídica).
person_id	string	Identificador interno de la persona en el OMS.
name	string	Nombre del cliente.
last_name	string	Apellido del cliente.
country	string	País de residencia del cliente.
email	string	Dirección de email del cliente.
genre	string	Género del cliente, según registrado en el OMS.
document_type	string	Tipo de documento de identidad (por ejemplo, DNI, CUIT, PASAPORTE).
document_number	string	Número de documento de identidad.
external_id	string	Identificador externo del cliente en los sistemas del broker.
investment_profile	string	Nivel de riesgo del cliente. Valores posibles: LOW, MEDIUM, HIGH.
instruments	array of string	Tipos de instrumentos que el cliente está autorizado a operar, derivados de su nivel de riesgo. Valores posibles: FUND, STOCKS, CEDEARS, BONDS, TREASURY_NOTES, ON, OPTIONS, REPO_ORDER, MEP_OPERATION.
expiration_date	string (fecha ISO 8601, yyyy-MM-dd)	Fecha de vencimiento del perfil de inversión actual del cliente.
allows_short_sell	boolean	Indica si el cliente está autorizado a realizar operaciones de short sell.
allows_repo_without_cash	boolean	Indica si el cliente está autorizado a realizar operaciones de caución (repo) sin efectivo disponible.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
404	Not Found — la cuenta no existe
500	Internal Server Error

Estructura del error:

{
  "code": "NOT_FOUND",
  "description": "Resource not found"
}

Ejemplo de código

cURL

curl -X GET https://b2b.allaria.cloud/v1/broker/investment-profile/12345 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const accountId = 12345;

const response = await fetch(
  `https://b2b.allaria.cloud/v1/broker/investment-profile/${accountId}`,
  {
    method: 'GET',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

account_id = 12345

response = requests.get(
  f'https://b2b.allaria.cloud/v1/broker/investment-profile/{account_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountId = 12345;

const response = await axios.get(
  `https://b2b.allaria.cloud/v1/broker/investment-profile/${accountId}`,
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Éxito

{
  "legal_entity": "ALLARIA",
  "person_type": "FISICA",
  "person_id": "998877",
  "name": "Juan",
  "last_name": "Pérez",
  "country": "ARGENTINA",
  "email": "juan.perez@example.com",
  "genre": "M",
  "document_type": "DNI",
  "document_number": "30123456",
  "external_id": "20301234567",
  "investment_profile": "MEDIUM",
  "instruments": ["FUND", "STOCKS", "BONDS"],
  "expiration_date": "2027-03-15",
  "allows_short_sell": false,
  "allows_repo_without_cash": false
}