Back to BlockTempMail

API References

Status Codes

HTTP status codes are three-digit numbers that are returned by a server in response to a client's request. These codes indicate the status of the requested resource and provide information on how the request was processed. Understanding HTTP status codes is essential for troubleshooting API requests and responses.

The following table lists the common HTTP status codes returned by the BlockTempMail API and their corresponding meanings:

Code Description
200 The request has succeeded. The server has returned the requested data.
400 The request could not be understood or was missing required parameters.
401 Authentication failed or the API token is invalid.
429 The user has sent too many requests in a given amount of time.

API Result

To help you better understand the data returned by the BlockTempMail API, we have provided a comprehensive table below that lists all the keys returned by the API and provides a brief description of each key's value.

Key Description
status The HTTP status code for the API response.
email The email address that was validated.
username The username part of the email address.
domain The domain part of the email address.
tempmail A boolean value indicating whether the email address is a temporary or disposable email address.
provider The email provider associated with the domain (if available).
mx The mail exchange (MX) records for the domain.
hourly_remaining The remaining API requests within the current hourly quota.
datetime The date and time the API response was generated.
error error.type
The error type can be one of these values: not_exist_mailbox, invalid_tld, invalid_email, or not_found_mx_record.
error.message
A message that provides more details about the error encountered.

At BlockTempMail, we offer you the flexibility to customize our API keys according to your specific needs. By filtering out the results that you don't need, you can save valuable time and resources. Our modular architecture allows you to tailor the API to your exact requirements, ensuring a seamless integration with your existing systems. With BlockTempMail, you are in control of your email verification process, ensuring the highest levels of efficiency and accuracy for your business needs.