Verificar residencia de cuenta

Verifica si el titular de una cuenta dada es una persona física residente (a diferencia de una persona física no residente o una persona jurídica), a los efectos de la residencia fiscal para operaciones MEP.

GET/v1/operations/usd-mep/is-resident/{accountNumber}

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
accountNumber	integer	Sí	Número de cuenta de cliente a verificar.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Cuerpo booleano sin envolver

A diferencia de la mayoría de los endpoints de esta API, este endpoint devuelve un booleano JSON simple como cuerpo de la respuesta, en lugar de un objeto JSON.

Campo	Tipo	Descripción
(raíz)	boolean	true si el titular de la cuenta es una persona física residente; false en caso contrario (persona física no residente o persona jurídica).

Códigos de error

Status	Descripción
400	Bad Request — accountNumber es inválido
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "BAD_REQUEST",
  "description": "Invalid account number"
}

Ejemplo de código

cURL

curl -X GET https://b2b.allaria.dev/v1/operations/usd-mep/is-resident/12345 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const accountNumber = 12345;

const response = await fetch(
  `https://b2b.allaria.dev/v1/operations/usd-mep/is-resident/${accountNumber}`,
  {
    method: 'GET',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

account_number = 12345

response = requests.get(
  f'https://b2b.allaria.dev/v1/operations/usd-mep/is-resident/{account_number}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountNumber = 12345;

const response = await axios.get(
  `https://b2b.allaria.dev/v1/operations/usd-mep/is-resident/${accountNumber}`,
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Éxito

true