> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/identity-api/identity-api-reference/onboarding/morphology/document-validation-v2/document-validation-status-v2.md).

# Document validation Status V2

Consulta el estado de la operación de validación morfológica. Se debe llamar a este endpoint **repetidamente** hasta que la operación de análisis se haya completado. Ver [Process Status](#process-status) como referencia de los diferentes valores de estado.

### Endpoint

```
POST /verify/documentValidation/v2/status
```

### Headers

| Nombre        | Tipo   | Requerido | Descripción                                                   |
| ------------- | ------ | --------- | ------------------------------------------------------------- |
| **x-api-key** | string | **Sí**    | API key de autorización de acceso.                            |
| **family**    | string | No        | Valor: **OnBoarding**. Requerido con el servicio de tracking. |

{% hint style="info" %}
Todas las llamadas a los Endpoints para tracking con **Identity Platform** deben contener el header `family`.
{% endhint %}

### Cuerpo de la solicitud

**Content-Type:** `application/json`

#### Parámetros

| Parámetro              | Tipo   | Requerido | Descripción                                                                                             |
| ---------------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------- |
| `scanReference`        | string | **Sí**    | **Número de referencia** del escaneo.                                                                   |
| `type`                 | string | No        | ⚠️ Valor **obsoleto**. Será eliminado en futuras versiones.                                             |
| `tracking`             | object | No        | Objeto que representa la información de seguimiento necesaria.                                          |
| `tracking.extraData`   | string | No        | Token generado por el SDK Mobile/Web. Contiene información de seguimiento tokenizada con la Plataforma. |
| `tracking.operationId` | string | No        | Identificador de operación generado por el SDK Mobile/Web.                                              |

#### Ejemplo de solicitud

```json
{
  "scanReference": "fe294c25-17e1-4d98-a958-710edbf00064",
  "tracking": {
    "extraData": "BQABAQG2gBNjuHN4kLmPqYf7R...",
    "operationId": "123e4567-e89b-12d3-a456-426614174000"
  }
}
```

### Respuestas

#### `200` Éxito

#### Parámetros de respuesta

| Parámetro       | Tipo   | Descripción                                                                                                   |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------- |
| `timestamp`     | string | Marca de tiempo (UTC) de la respuesta en formato **ISO 8601**.                                                |
| `scanReference` | string | **Número de referencia** del escaneo.                                                                         |
| `status`        | string | Estado de la operación. Valores posibles: `PENDING`, `DONE`, `FAILED`. Ver [Process Status](#process-status). |

#### Process Status

El endpoint de status retorna uno de los siguientes valores para indicar el estado actual del proceso de validación:

| Status      | Descripción                                                                                                                   |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **PENDING** | Análisis en progreso. Se **recomienda** consultar cada 5 segundos hasta que se complete.                                      |
| **DONE**    | Validación completada exitosamente. Ejecute el servicio Document Validation Data V2 para obtener los resultados del análisis. |
| **FAILED**  | El proceso de validación encontró un error y no pudo completarse.                                                             |

#### Ejemplo de respuesta

```json
{
  "timestamp": "1970-01-01T00:00:00.000Z",
  "scanReference": "fe294c25-17e1-4d98-a958-710edbf00064",
  "status": "DONE"
}
```

#### `400` Bad Request

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Unauthorized

```json
{
  "message": "Unauthorized"
}
```

#### `403` Forbidden

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `502` Bad Gateway

```json
{
  "status": 502,
  "title": "Bad Gateway",
  "detail": "Server got an invalid response.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Gateway Timeout

```json
{
  "message": "Endpoint request timed out"
}
```