# 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.


---

# 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.stopbot.net/api-documentation/email-validation.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.