Retrieve Identity Document

Obtiene la documentación de identidad asociada a una persona humana mediante su person_id.

Consultá la documentación de identidad cargada para una persona humana usando su person_id.

Antes de empezar

1. Tené a mano el person_id de la persona cuya documentación querés consultar.
2. Usá este endpoint después de cargar la documentación de identidad para validar que las imágenes quedaron asociadas correctamente.
3. Verificá que la persona exista antes de hacer la consulta.

Cómo consultar la documentación de identidad

HTTP

GET /api/accounts/persons/identity-document/{person_id}

Path parameters

Parámetro	Tipo	Requerido	Descripción
person_id	string	Sí	Identificador de la persona humana cuya documentación querés consultar.

Qué devuelve este endpoint

La respuesta devuelve un arreglo items con la documentación asociada a la persona consultada.

Cada elemento puede incluir:

• person_id: identificador de la persona
• face: imagen del rostro
• front: frente del documento
• back: dorso del documento

Respuesta esperada

JSON

{
  "items": [
    {
      "person_id": "F-8d567d64-3043-47de-8aa8-5d1d39f56c9e",
      "face": "<base64_face>",
      "front": "<base64_front>",
      "back": "<base64_back>"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• validar que la documentación fue cargada correctamente
• recuperar las imágenes asociadas a una persona
• auditar el estado de la documentación antes de continuar un flujo de onboarding o validación

Errores frecuentes

• 404 Not Found: no existe documentación asociada al person_id enviado.
• 422 Validation Error: el person_id tiene un formato inválido.

Siguiente paso

Después de validar la documentación, continuá con el flujo de onboarding, validación o apertura de cuenta que dependa de esta información.