Consultá la información completa de una persona usando su person_id o su tax_identification_value.

Antes de empezar

1. Elegí uno de estos criterios de búsqueda: person_id o tax_identification_value.
2. Enviá solo el parámetro que necesites para identificar a la persona.
3. Verificá que el valor consultado exista antes de usar la respuesta en otros flujos, como alta de cuentas comitentes o validaciones posteriores.

Cómo consultar una persona

Podés recuperar una persona por alguno de estos query parameters:

• person_id
• tax_identification_value

Consultar por tax_identification_value

GET /api/accounts/persons?tax_identification_value=20341111111

Consultar por person_id

GET /api/accounts/persons?person_id=F-8d567d64-3043-47de-8aa8-5d1d39f56c9e

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un objeto con:

• person_id: identificador único de la persona
• person: datos completos de la persona consultada

Dentro de person podés recibir:

• datos generales, como job_activity_id, country_document_id, nationality_id, is_aml_cft_subject e is_pep
• datos impositivos en tax_identifications
• domicilios en domiciles
• contacto en contact_info
• datos de persona humana en human_person, si corresponde
• datos de persona jurídica en legal_person, si corresponde

Respuesta esperada

{
  "person_id": "F-8d567d64-3043-47de-8aa8-5d1d39f56c9e",
  "person": {
    "job_activity_id": 12112,
    "country_document_id": "ARG",
    "is_aml_cft_subject": false,
    "is_pep": false,
    "domiciles": [
      {
        "domicile_type_id": "PA",
        "house_number": 121,
        "street": "9 de Julio",
        "floor": 7,
        "apartment": "C",
        "country_id": "ARG",
        "province_id": "AR-B",
        "zip_code": 2324,
        "location_id": 1
      }
    ],
    "tax_identifications": {
      "tax_identification_value": "20341111111",
      "residence_country_id": 54,
      "tax_identification_type_id": "CUIT",
      "taxpayer_income_tax_type_id": "NOINS",
      "vat_taxpayer_type_id": "RM",
      "vat_country_taxpayer_type_id": 54
    },
    "human_person": {
      "name": "Juan",
      "surname": "Perez",
      "document_type_id": "DNI",
      "document_num": 34111112,
      "civil_status_id": "SOL",
      "birth_date": "2022-12-15",
      "birth_place": "ARG",
      "gender_id": "M"
    },
    "nationality_id": "ARG",
    "contact_info": {
      "email": "[email protected]",
      "mobile_phone": "+541112345678"
    }
  }
}

Errores frecuentes

• 404 Not Found: la persona consultada no existe o no está disponible.
• 422 Validation Error: el formato del query parameter es inválido.

Siguiente paso

Usá los datos devueltos por este endpoint para validar la información de la persona antes de crear una cuenta comitente, asociar documentación o consultar cuentas vinculadas por person_id.