Получение информации о подписчиках

GET https://mailganer.com/api/v2/emails/

Список параметров запроса

Особенности работы с фильтрами по датам:

Если указаны оба параметра (например, start_date и end_date), возвращаются подписчики, созданные в указанном периоде (включительно)
Если параметры дат не указаны - возвращаются все подписчики
При пустом результате возвращается: {"results": [], "count": 0}

Альтернативный способ обратиться к данному методу - подставить mg_hash имейла в url. Например, https://mailganer.com/api/v2/emails/53158545763880e054b31ecbad2cf3265d4001d1/

Пример запросов

https://mailganer.com/api/v2/emails/

https://mailganer.com/api/v2/emails/?email=test@example.com&source=49767

https://mailganer.com/api/v2/emails/?start_date=2024-10-10&end_date=2025-10-10

https://mailganer.com/api/v2/emails/?updated_at_start=2025-10-29&updated_at_end=2025-10-30

Список параметров ответа (json)

Пример ответа в случае успеха (json)

{
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 321456817,
            "mg_hash": "54ede83211718173f544604ebe5ad1867543b348185",
            "email": "test@gmail.com",
            "source": 104363,
            "email_status": "active",
            "corrected_email": null,
            "name": "",
            "patronymic": "",
            "surname": "",
            "gender": 0,
            "birthday": null,
            "phone": null,
            "city": null,
            "country": null,
            "is_valid": false,
            "doi_is_delivery": false,
            "doi_is_open": false,
            "doi_is_click": false,
            "user_vars": {
                "date_glob": null,
                "glob": 66432,
                "globalnayatest1": null,
                "str_glob_2": null
            },
            "bunce_log": null,
            "tags": [],
            "categories": [],
            "created": "2026-03-03T16:06:29.724362",
            "modified": "2026-03-03T16:06:29.740263"
        }
    ],
    "count": 1
}

Возможные значения статусов подписчика

Пример ответов в случае ошибки (json)

{
    "status": "invalid",
    "error": {
        "source": ["Not found site (source_id=497671) or site blocked"],
        "birthday": ["Неправильный формат date. Используйте формат: DD.MM.YYYY"],
        ...
    }
}

{
    "status": "invalid",
    "error": {
        "end_date": [
            "Введите правильную дату."
        ]
    }
}

{
    "status": "invalid",
    "error": {
        "detail": "start_date cannot be later than end_date"
    }
}