# Email Validation

## REQUEST

### Endpoint

```url
https://stopbot.net/api/email-validation?apikey={APIKEY}&email={email}
```

### Method

```
GET
```

### Parameters

* `apikey` (string, required): The API key provided to the user.
* `email` (string, required): The email to be identified. \
  Example:\
  `email@mailinator.com`

### Example Request

```bash
CURL "https://stopbot.net/api/email-validation?apikey=9ca6f45b2e9821b3a964c0f79cb67dc3&email=email@mailinator.com"
```

## **Example Response**

### Success Response

If the HTTP response is 200 (success response), it will generate the following response:

```json
{
  "isEmail": "true",
  "info": {
    "user": "email",
    "domain": "mailinator.com",
    "isDisposableEmail": 1,
    "mx": "configured",
    "spf": "configured",
    "dmarc": "configured"
  },
  "status": "success",
  "timeResponse": "2023-06-8 23:00"
}
```

### Description on successful response

* `isEmail`: Indicates whether the email parameter is a valid email address. The value true indicates a valid email address, while false indicates an invalid email address.
* `info`: Contains information related to the email address.
  * `user`: The user part of the email address.
  * `domain`: The domain of the email address.
  * `isDisposableEmail`: Indicates whether the email address is a disposable email address. A value of 1 indicates a disposable email address.
  * `mx`: MX (Mail Exchange) configuration status for the domain.
  * `spf`: SPF (Sender Policy Framework) configuration status for the domain.
  * `dmarc`: DMARC (Domain-based Message Authentication, Reporting, and Conformance) configuration status for the domain.
* `status`: Indicates the success or failure of the request.
* `timeResponse`: Date and time when the response was sent.

### Failed Response

If the HTTP response is 400 or 401 (failed response), it will generate the following response:

```json
{
  "status": "failed",
  "timeResponse": "2023-06-8 23:00"
}
```

### Description on failed response:

* `status`: Response Status: The value is "failed" if the request fails.
* `timeResponse`: Date and time when the response was sent.