Welcome to MailsAPI API Documentation! 🚀

API URL https://api.mailsapi.org

KOPEECHKA host fix

Basic request

Endpoint: /user-balance

To check your balance, make the following API call.


Request parameters
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/user-balance?token=YOUR_API_TOKEN&type=json

Response success

type=json
{"status":"OK","balance":"660.928"}
type=text
OK|660.8664

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN

Work with mail

Endpoint: /mailbox-get-email

Getting a new email address.


Request parameters
site string Required The website for which an email address is needed.
mail_type string Optional The type of email (domain or email service)
soft integer Optional Used by developers in the referral program
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-get-email?site=instagram.com&mail_type=gmail&type=json&api=2.0&token=YOUR_API_TOKEN

Response success

type=json
{"status":"OK","id":917928,"mail":"[email protected]"}
type=text
OK|904670|[email protected]

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN
{"status":"ERROR","value":"BAD_SITE"}
ERROR|BAD_SITE
{"status":"ERROR","value":"BAD_DOMAIN"}
ERROR|BAD_DOMAIN
{"status":"ERROR","value":"BAD_BALANCE"}
ERROR|BAD_BALANCE
{"status":"ERROR","value":"OUT_OF_STOCK"}
ERROR|OUT_OF_STOCK

Endpoint: /mailbox-get-message

A request to receive emails using the previously obtained email address, using the activation id.


Request parameters
id integer Required ID of the activation for which we should receive the message.
full integer Optional Specify 1 if you want to return the full message, not just the link (sometimes needed to save bandwidth).
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-get-message?id=24&full=1&type=json&token=YOUR_API_TOKEN

Response success

type=json
{"status":"OK","value":"https://instagram.com/accounts/...","fullmessage":"<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">..."}
type=text
OK|https://instagram.com/accounts/...|<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">...

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN
{"status":"ERROR","value":"WAIT_LINK"}
ERROR|WAIT_LINK
{"status":"ERROR","value":"NO_ACTIVATION"}
ERROR|NO_ACTIVATION

Endpoint: /mailbox-cancel

Cancellation of the previously provided email address with a refund (if the email is not received).


Request parameters
id integer Required The activation ID that needs to be canceled.
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-cancel?token=YOUR_API_TOKEN&id=126952&soft_id=76&type=json

Response success

type=json
{"status":"OK"}
type=text
OK

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN
{"status":"ERROR","value":"NO_ACTIVATION"}
ERROR|NO_ACTIVATION

Endpoint: /mailbox-reorder

Reorder of the previously provided email address.


Request parameters
site string Required The website for which an email address is needed.
email string Required Mail for which you want to receive a follow-up message.
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-reorder?token=YOUR_API_TOKEN&email=kcox6c5a@last30geng247.top&site=instagram.com&type=json

Response success

type=json
{"status":"OK","id":28,"mail":"[email protected]"}
type=text
OK|920452|[email protected]

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN
{"status":"ERROR","value":"BAD_EMAIL"}
ERROR|BAD_EMAIL
{"status":"ERROR","value":"NO_ACTIVATION"}
ERROR|NO_ACTIVATION

Endpoint: /mailbox-get-fresh-id

Find activation id from site and email.


Request parameters
site string Required The site you are working with.
email string Required Mail for which you want to receive a follow-up message.
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-get-fresh-id?token=YOUR_API_TOKEN&site=instagram.com&email=kcox6c5a@last30geng247.top

Response success

type=json
{"status":"OK","id":25}
type=text
OK|25

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN
{"status":"ERROR","value":"NO_ACTIVATION"}
ERROR|NO_ACTIVATION

Work with domain lists

Endpoint: /mailbox-get-domains

List of all domains in our system.


Request parameters
token string Required Your api key
type string Optional Response type json/text (default: json)


Example:

URL request

https://api.mailsapi.org/mailbox-get-domains?token=YOUR_API_TOKEN

Response success

type=json
{"status":"OK","count":4703,"domains":["link-audot.top","evonu.cfd","aaqx.cfd"]}
type=text
OK|4449|["link-audot.top","cfxcinema.online"]

Response error

type=json
{"status":"ERROR","value":"BAD_TOKEN"}
type=text
ERROR|BAD_TOKEN