> For the complete documentation index, see [llms.txt](https://kopeechka-py-lib.gitbook.io/kopeechka/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kopeechka-py-lib.gitbook.io/kopeechka/classes/asyncmailactivations/mailbox_get_email.md).

# mailbox\_get\_email

Описание асинхронного метода mailbox\_get\_email()

## Описание

### Аргументы:

* site: str (обязательный аргумент) - Сайт, для которого вам нужна почта.
* mail\_type: str - Укажите тип почты (mail.ru, например), которую хотите получить.

  Если оставить пустым (или написать ALL) - будут выдаваться случайные почты из НАШИХ ДОМЕНОВ.

  Напишите REAL, если вам нужны только почты на популярных доменах (mail.ru, outlook.com, gmail.com и т.д.).

  Для удобства, можно использовать целые группы почт:

  mail\_type=YANDEX (берутся домены Yandex)

  mail\_type=OUTLOOK (берутся только домены outlook / hotmail)

  mail\_type=MAILCOM (берутся домены mail.com)

  mail\_type=MAILRU (берутся домены mail.ru)

  mail\_type=RAMBLER (берутся домены Rambler)

  mail\_type=GMX (берутся домены GMX)

  \*mail\_type=mine (берутся все Ваши привязанные домены, которые привязали с помощью <https://t.me/kopeechka\\_bot>)

  mail\_type=ALL,mail.ru
* regex: str - Укажите регулярное выражение, чтобы спарсить информацию, если вам не нужно всё письмо
* soft\_id: int - Используется разработчиками в реферальной программе. (Если хотите поддержать разработчика этой библиотеки, не трогайте этот аргумент ;D )
* investor: int - Укажите 1, если вам необходимо, чтобы почты брались не из общей базы, а из ваших собственных заливов (через Telegram бота).
* subject: str - Укажите, если хотите получить письмо с определенной темой (достаточно одного слова). Является приоритетным. Если указанного слова в теме не будет - письмо НЕ ВЫДАСТ!

  Например: тема 'Для регистрации аккаунта Facebook', в параметре укажите 'регистрации' - найдет нужное письмо. Если вы укажете в параметре 'активации' - письмо не выдаст
* password: int - Укажите 1, если вам нужен пароль к почте для [webmail](https://webmail.kopeechka.store/)
* token: str (обязательный аргумент) - API-ключ для работы с сервисом kopeechka (Указывать не нужно, он уже указан при создании класса)
* type: str - Какой тип ответа вы ожидаете увидеть (Указывать не нужно)

### Ответ:

Возвращает объект [GetEmail](/kopeechka/types/getemail.md) при статусе "OK" (при статусе ERROR вызывается исключение [KopeechkaApiError](/kopeechka/exceptions/kopeechkaapierror.md))

### Пример использования:

```python
from kopeechka import AsyncMailActivations
import asyncio

api = AsyncMailActivations("TOKEN")

async def main():
    ans = await api.mailbox_get_email("vk.com")
    print(ans)

asyncio.run(main())
```