> 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/docs.facephi-pt-br/api-rest/midapi-v2/validation-services/email-validation.md).

# Validação de e-mail

Serviço que avalia o risco de fraude associado a um endereço de e-mail.

### Endpoint

```
GET /validation/email/{email}
```

### Cabeçalhos

| Nome              | Tipo   | Obrigatório | Descrição                                                                                                                   |
| ----------------- | ------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sim**     | Token de consumer no formato `Bearer <token>`. Ver [Autenticação](/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sim**     | Identificador do consumer.                                                                                                  |

### Parâmetros de rota

| Parâmetro | Tipo   | Obrigatório | Descrição                          |
| --------- | ------ | ----------- | ---------------------------------- |
| `email`   | string | **Sim**     | Endereço de e-mail a ser avaliado. |

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro       | Tipo    | Descrição                                                   |
| --------------- | ------- | ----------------------------------------------------------- |
| `consumerId`    | string  | Identificador do consumer que realizou a chamada.           |
| `transactionId` | string  | Identificador da transação.                                 |
| `timestamp`     | string  | Carimbo de data e hora da resposta no formato **ISO 8601**. |
| `message`       | string  | Campo descritivo do resultado da execução do serviço.       |
| `type`          | string  | Tipo de dado consultado: `IP`, `EMAIL` ou `PHONE`.          |
| `fraud`         | boolean | Indica se o dado é considerado fraudulento.                 |
| `data`          | object  | Detalhe dos sinais de risco avaliados.                      |

#### Outras respostas

| Código | Descrição                                                          |
| ------ | ------------------------------------------------------------------ |
| `401`  | Token ausente, inválido ou expirado.                               |
| `403`  | O consumer não está provisionado com o serviço `EMAIL_VALIDATION`. |

O corpo de uma resposta de erro tem o formato descrito em [MIDAPI v2](/docs.facephi-pt-br/api-rest/midapi-v2.md#respuestas-de-error).