> 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/midapi-v2/voice-services/voice-authentication.md).

# Voice Authentication

Servicio que compara un audio contra una plantilla de voz emitida en el enrolamiento y devuelve el resultado con su puntuación.

### Endpoint

```
POST /biometric/voice/authentication
```

### Headers

| Nombre            | Tipo   | Requerido | Descripción                                                                                               |
| ----------------- | ------ | --------- | --------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sí**    | Token de consumer en formato `Bearer <token>`. Ver [Autenticación](/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sí**    | Identificador del consumer.                                                                               |

### Cuerpo de la solicitud

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

#### Parámetros

| Parámetro  | Tipo   | Requerido | Descripción                                                                                            |
| ---------- | ------ | --------- | ------------------------------------------------------------------------------------------------------ |
| `audio`    | string | **Sí**    | Audio a autenticar, en Base64.                                                                         |
| `template` | string | **Sí**    | Plantilla de voz emitida en el [enrolamiento](/api-rest/midapi-v2/voice-services/voice-enrollment.md). |

#### Ejemplo de solicitud

```json
{
  "audio": "<base64 audio>",
  "template": "<plantilla de voz>"
}
```

### Respuestas

#### `200` Éxito

#### Parámetros de respuesta

| Parámetro         | Tipo    | Descripción                                                   |
| ----------------- | ------- | ------------------------------------------------------------- |
| `consumerId`      | string  | Identificador del consumer que realizó la llamada.            |
| `transactionId`   | string  | Identificador de la transacción.                              |
| `timestamp`       | string  | Marca de tiempo de la respuesta en formato **ISO 8601**.      |
| `message`         | string  | Campo descriptivo del resultado de la ejecución del servicio. |
| `operationResult` | integer | Código de resultado de la ejecución del servicio.             |
| `match`           | boolean | Indica si el audio corresponde a la plantilla.                |
| `matchingScore`   | number  | Puntuación de coincidencia.                                   |
| `livenessScore`   | number  | Puntuación de prueba de vida del audio.                       |

#### Otras respuestas

| Código | Descripción                                                                    |
| ------ | ------------------------------------------------------------------------------ |
| `400`  | Campo obligatorio ausente, audio con formato no admitido o plantilla inválida. |
| `401`  | Token ausente, inválido o caducado.                                            |
| `403`  | El consumer no está aprovisionado con el servicio `VOICE_AUTHENTICATION`.      |

El cuerpo de una respuesta de error tiene la forma descrita en [Middleware API v2](/api-rest/midapi-v2.md#respuestas-de-error).