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

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": "https://mailganer.com/api/v2/emails/?end_date=2025-10-10&page=2&start_date=2024-10-10",
    "previous": null,
    "results": [
        {
            "id": 23765,
            "mg_hash": "d78412da135dcd",
            "email": "test@gmail.com",
            "source": 94875,
            "email_status": "not_available",
            "corrected_email": null,
            "name": "",
            "patronymic": "",
            "surname": "",
            "gender": 0,
            "birthday": null,
            "phone": null,
            "city": null,
            "country": null,
            "is_valid": true,
            "doi_is_delivery": false,
            "doi_is_open": false,
            "doi_is_click": false,
            "user_vars": {
                "glob": null,
                "int_14987_glob": 0
            },
            "bunce_log": "User stop list email hash: a6f6baacfb7a16f1029283855",
            "tags": [],
            "categories": [],
            "created": "2025-07-14T16:30:30.537687",
            "modified": "2025-11-05T14:45:12.921890"
        }
    ],
    "count": 123808
}

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

Пример ответов в случае ошибки (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"
    }
}