Email Validation

Here is an example API documentation for the endpoint used for Email Validation.

REQUEST

Endpoint

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

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:

{
  "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:

{
  "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.

Last updated