# Detalle de la validación

<mark style="color:blue;">**GET**</mark>  `https://api.zapsign.com.br/api/v1/signer-verification-details/{{signer_token}}/`&#x20;

#### Header

<table><thead><tr><th width="175">Nombre</th><th width="103">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200 - Exitoso" %}

```json
{
    "token": "0abe0677-72d7-4816-9ba8-317145d387ea",
    "selfie_validation_type": "identity-verification-global",
    "validations": [
        {
            "type": "Identity verification",
            "validation_number": "cd461e6a-a5d5-4bd7-8e50-20263c9f64a9",
            "status": "success",
            "reason": "",
            "created_at": "2025-06-05T18:51:26.286366Z",
            "document_photo_url": "https://zapsign.s3.amazonaws.com",
            "document_verse_photo_url": "https://zapsign.s3.amazonaws.com/",
            "selfie_photo_url": "",
            "document_ocr": {
                "process_id": "cd461e6a-a5d5-4bd7-8e50-20263c9f64a9",
                "name": "MARIA",
                "last_name": "SOUZA",
                "document_type": "ID_CARD",
                "document_number": "11111111",
                "date_of_birth": "1980-01-01",
                "document_country": "BR"
            }
        },
        {
            "type": "Name validation",
            "status": "success",
            "reason": "",
            "created_at": "2025-06-05T18:51:26.286366Z"
        }
    ]
}

```

{% endtab %}

{% tab title="404 - Not found" %}

```json
{
    "error": "Signer not found"
}
```

{% endtab %}
{% endtabs %}

### Sobre el resultado de la validación

Este endpoint permite consultar el **resultado del proceso de validación** definido en el parámetro `selfie_validation_type`.\
Cada tipo de validación posee **etapas específicas** que verifican diferentes aspectos del documento y/o del rostro del firmante.

Dentro de cada etapa existen **sub-validaciones**, y para cada una de ellas la respuesta del endpoint retorna:

* El **estado** (éxito o fallo).
* El campo **reason**, que explica el motivo del fallo, cuando aplica.

A continuación, se detallan los diferentes tipos de validación disponibles y sus etapas correspondientes:

***

**liveness-document-match**

Este método realiza **dos validaciones principales**:

* **Document recognition**: verifica si la foto enviada del frente del documento realmente corresponde a un documento de identidad y si contiene una foto.

  > Importante: no aplica modelos avanzados de fraude ni identifica casos de “foto de foto”.
* **Face match**: compara el video pasivo del rostro del firmante con la foto del documento presentado, garantizando que se trata de la misma persona. El resultado incluye la URL de la foto de rostro capturada.

***

**face-match-and-datavalid**

Disponible solo para **Brasil – CNH**. Este método realiza **una única validación**:

* Compara el **nombre y CPF** con las bases del **Serpro**, además de verificar si coinciden con la persona identificada en el video pasivo realizado durante la firma.

***

**identity-verification-global**

Este método realiza **tres validaciones complementarias**:

* **Identity verification**: valida que el documento sea real utilizando modelos de detección de fraude y retorna los datos extraídos automáticamente (OCR), incluyendo:
  * `name`
  * `last_name`
  * `document_type`
  * `document_number`
  * `date_of_birth`
  * `document_country`
* **Name validation**: compara el nombre extraído del documento con el nombre informado por el firmante. La validación se considera aprobada si la similitud es **mayor al 75%**.
* **Validación de CPF (Brasil)**: cuando el documento es de Brasil y contiene CPF, se realiza una verificación automática en la Receita Federal.

***

#### **identity-verification**

Disponible para **Colombia, México, Chile y Perú**. Este método realiza **dos validaciones**:

* **Identity verification**: valida que el documento sea real con modelos de fraude, realiza consulta en bases de datos del gobierno y garantiza que el video pasivo corresponda a la misma persona del documento.
* **Name validation**: compara el nombre extraído del documento con el nombre informado por el firmante, aplicando la misma lógica de similitud usada en el método *identity-verification-global*.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zapsign.com.br/espanol/firmantes/signer-verification-details.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.