MAIL REQUest

http://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&sender=$SENDER&regex=$REGEX&token=$TOKEN&soft=$SOFT_ID&investor=$INVESTOR&type=$ANSWER_TYPE&subject=$SUBJECT&clear=$CLEAR&api=2.0

Note, that the required parameters are $TOKEN,$SITE.

$SITE - The site you need mail for.

$MAIL_TYPE - Specify the type of mail (mail.ru , for example), which you want to get. If you leave it empty (or write ALL), random emails from OUR DOMAINS will be issued. Write REAL if you only need mail on popular domains (mail.ru , outlook.com , gmail.com etc.).
For convenience, you can use whole groups of mail:

  • mail_type=YANDEX (only Yandex)

  • mail_type=OUTLOOK (only outlook / hotmail)

  • mail_type=MAILCOM (only mail.com)

  • mail_type=MAILRU (only mail.ru)

  • mail_type=RAMBLER (only Rambler)

  • mail_type=GMX (only GMX)

*mail_type=mine (All your domains, added in https://t.me/kopeechka_bot)


mail_type=ALL,mail.ru

$SENDER -it is used if there is no $SITE in the sender's address (from whom we are waiting for the letter) (in 98% of cases, it is there and you do not need to enter it).

If you specify more than 2 or more sites and want to specify the sender, then enter the sender for each site accordingly. For example, you specified site=vasya.com,petya.ru, then it is necessary to specify the senders as follows: vasya,petya and in no other way, or you will receive an error / the letter will not reach.

$REGEX - it is intended for your regular expression so that we can find the information for you ourselves and give you only that.

If you specify more than 2 or more sites and want to specify a reg. expression, then enter it for each site, respectively, through the separator |,|. For example, you specified site=vasya.com ,petya.ru , then regex=.*|,|\d{1} , where .* - expression for vasya.com, and \d{1} is an expression for petya.ru

$SOFT_ID - used by developers in the referral program.

$TOKEN - Your API key from kopeechka.store

$INVESTOR - Specify 1 if you need the mail to be taken not from the general database, but from your own bays (via Telegram bot.

$ANSWER_TYPE - What type of response do you expect to see (JSON/TEXT) (by default JSON)

$SUBJECT - Specify if you want to receive an email with a specific subject (one word is enough). Is a priority. If the specified word is not in the subject, the letter will NOT GIVE OUT!
For example: the subject is "For Facebook account registration", specify "registration" in the parameter - it will find the necessary letter. If you specify "activation" in the parameter, the email will not issue

$CLEAR - Specify in parameter 1 if you want to receive mailboxes that do not contain signs: - . _ .

✅ Answer:

JSON

{"status":"OK","id":$TASK_ID,"mail":"$MAIL"}

TEXT

OK|$TASK_ID|$MAIL

$TAKS_ID -by this parameter, you need to make further requests to the kopeechka.store service. This is your activation number.
$MAIL - Mail from the service.

❌ Possible errors:

  • Invalid token

JSON

{"status":"ERROR","value":"BAD_TOKEN"}

TEXT

ERROR|BAD_TOKEN


  • You specified the site incorrectly.

JSON

{"status":"ERROR","value":"BAD_SITE"}

TEXT

ERROR|BAD_SITE

  • We do not have such a domain/domain zone.

JSON

{"status":"ERROR","value":"BAD_DOMAIN"}

TEXT

ERROR|BAD_DOMAIN

  • There are not enough funds to perform the operation.

JSON

{"status":"ERROR","value":"BAD_BALANCE"}

TEXT

ERROR|BAD_BALANCE

  • There is no mail with such settings. Try changing $MAIL_TYPE or write to support - let's try adding mailboxes.

JSON

{"status":"ERROR","value":"OUT_OF_STOCK"}

TEXT

ERROR|OUT_OF_STOCK

JSON

{"status":"ERROR","value":"SYSTEM_ERROR"}

TEXT

ERROR|SYSTEM_ERROR

  • The limit of mail orders per second has been reached (applies to special tariffs), it is necessary to expand the tariff.

JSON

{"status":"ERROR","value":"TIME_LIMIT_EXCEED"}

TEXT

ERROR|TIME_LIMIT_EXCEED

Have you figured it out? Rather try :)