# Nachrichtenstatistiken ## messages:list Zeigt die Liste der gesendeten Nachrichten an. `POST` `https://api.pushwoosh.com/api/v2/messages:list` ##### Headers | Name
| Erforderlich
| Beschreibung
| |----------------|----------|------------------------------------------------------------------------------------------------------| | `Authorization`| Ja | [Server-API-Token](/de/developer/api-reference/api-access-token/#server-api-token). Muss im folgenden Format angegeben werden: `Authorization: Api `. | ##### Parameter des Request-Body | Name
| Erforderlich
| Typ
| Beschreibung
| |--------------------------------------|----------|---------|--------------------------------------------------------------------------------------------------------------------------------| | `platforms` | Nein | Array | Nachrichtenplattformen. Mögliche Werte: `"IOS"`, `"ANDROID"`, `"OSX"`, `"WINDOWS"`, `"AMAZON"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"IE"`, `"EMAIL"`, `"HUAWEI_ANDROID"`, `"SMS"`. | | `date_range` | Nein | Object | Berichtszeitraum. `date_from` und `date_to` müssen dem Format `YYYY-MM-DD` folgen (z. B. `"2000-01-01"`). | | `campaign` | Nein | String | [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code) | | `filters` | Ja | Object | Nachrichtenfilter. | | `source` | Nein | String | Nachrichtenquelle. Zum Beispiel: `AB_TEST`, `API`, `AUTO_PUSH`, `CP`, `CSV`, `CUSTOMER_JOURNEY`, `EMAIL_API`, `EMAIL_CP`, `GEO_ZONE`, `PUSH_ON_EVENT`, `RSS`. | | `messages_codes` | Nein | Array | [Nachrichtencodes](/de/developer/api-reference/api-identifiers/#message-code), erhalten aus `/createMessage` API-Antworten. | | `messages_ids` | Nein | Array | Nachrichten-IDs, erhalten aus dem Nachrichtenverlauf. | | `params` | Nein | Object | Geben Sie an, ob Nachrichtendetails und Metriken angezeigt werden sollen. Setzen Sie `with_details: true`, um das Objekt `"details"` einzuschließen, und `with_metrics: true`, um das Objekt `"metrics"` in die Antwort aufzunehmen. | | `application` | Ja | String | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code). | | `per_page` | Nein | Integer | Anzahl der Ergebnisse pro Seite (≤ 1000). | | `page` | Nein | Integer | Seitennummer für die Paginierung. | ##### Beispielanfrage ``` { "filters": { "platforms": [], // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS "date_range": { "date_from": "string", // Erforderliches Format: 2000-01-01 "date_to": "string" // Erforderliches Format: 2000-01-01 }, "source": "API", // AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS "campaign": "string", // Kampagnencode "messages_ids": [], // Nachrichten-IDs "messages_codes": [], // Nachrichtencodes "application": "string" // Pushwoosh-Anwendungscode }, "params": { "with_details": true, // Nachrichtendetails zur Antwort hinzufügen (Objekt "details") "with_metrics": true // Nachrichtenmetriken zur Antwort hinzufügen (Objekt "metrics") }, "per_page": 20, // <= 1000 "page": 0 } ```
Antwortcodes und Beispiele ``` { "total": 0, "items": [{ "id": 0, "code": "string", "created_date": "string", "send_date": "string", "status": "string", "platforms": [], "source": "string", "push_info": { "details": { "title": "string", "filter_name": "string", "filter_code": "string", "content": { "key": "value" }, "platform_parameters": { "android_header": "string", "android_root_params": { "key": "value" }, "ios_title": "string", "ios_subtitle": "string", "ios_root_params": { "key": "value" }, "chrome_header": "string", "chrome_root_params": { "key": "value" }, "firefox_header": "string", "firefox_root_params": { "key": "value" }, "conditions": [ // Tag-Bedingungen (siehe /developer/api-reference/messages-api/#tag-conditions) TAG_CONDITION1, TAG_CONDITION2, ..., TAG_CONDITIONN ], "conditions_operator": "AND", // logischer Operator für Bedingungs-Arrays; mögliche Werte: AND, OR "data": { "key": "value" } }, "follow_user_timezone": true }, "metrics": [{ "sends": 0, "opens": 0, "deliveries": 0, "inbox_opens": 0, "unshowable_sends": 0, "errors": 0, "platform": 0 }] }, "email_info": { "details": { "template": "string", "filter_name": "string", "filter_code": "string", "subject": { "key": "value" }, "from_name": "string", "from_email": "string", "reply_name": "string", "reply_email": "string", "follow_user_timezone": true, "conditions": [ // Tag-Bedingungen (siehe Messages-api - tag-conditions) TAG_CONDITION1, TAG_CONDITION2, ..., TAG_CONDITIONN ], "conditions_operator": "AND" // logischer Operator für Bedingungs-Arrays; mögliche Werte: AND, OR }, "metrics": [{ "sends": 0, "opens": 0, "deliveries": 0, "hard_bounces": 0, "soft_bounces": 0, "rejects": 0, "confirmed_sends": 0, "unsubs": 0, "complaints": 0, "errors": 0 }] } }] } ``` ```json { "error": "exceeded the maximum date interval. Max interval: 30 days" } ``` ```json { "error": "account not found" } ```
## totalsByIntervals Gibt Metriken und Konversionsdaten basierend auf dem Nachrichtencode zurück, aggregiert nach Stunden. **POST** `https://api.pushwoosh.com/api/v2/statistics/messages/totalsByIntervals` ##### Autorisierung Die Autorisierung erfolgt über das API-Zugriffstoken im Request-Header. ##### Parameter des Request-Body | Parametername
| Typ
| Beschreibung | Erforderlich | |----------------|--------|-----------------------------|----------| | `message_code` | string | [Nachrichtencode](/de/developer/api-reference/api-identifiers/#message-code), erhalten aus `/createMessage` API-Antworten. | Ja | | `platforms` | [int] | [Plattformen](/de/developer/api-reference/messages-api/api-prerequisites/#platforms) | Nein | ##### Beispielanfrage ``` { "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // erforderlich. Eindeutige Nachrichtenkennung "platforms": [1, 3, 7, 10, 11, 12] // optional. Liste der Plattformcodes } ``` ##### Antwortfelder | Name | Typ | Beschreibung | |-------------------|--------|-------------------------------------------------------------------| | **`metrics`** | **array** | **Enthält ein Array von Nachrichtenmetriken** | | `timestamp` | string | Der Zeitpunkt der Metrik. | | `platform` | int | Der Plattformcode (z. B. iOS, Android). | | `sends` | string | Die Anzahl der gesendeten Nachrichten. | | `opens` | string | Die Anzahl der geöffneten Nachrichten. | | `deliveries` | string | Die Anzahl der zugestellten Nachrichten. | | `inbox_opens` | string | Die Anzahl der Öffnungen im Posteingang. | | `unshowable_sends`| string | Die Anzahl der gesendeten Nachrichten, die nicht angezeigt werden konnten. | | `errors` | string | Die Anzahl der Fehler. | | **`conversion`** | **object** | **Enthält Konversionsdaten** | | `sends` | string | Die Gesamtanzahl der gesendeten Nachrichten. | | `opens` | string | Die Gesamtanzahl der geöffneten Nachrichten. | | **`events`** | **array** | **Ein Array von Ereignissen mit ihren Statistiken** | | `name` | string | Der Name des Ereignisses (z. B. cart_add). | | `hits` | string | Die Anzahl der Treffer. | | `conversion` | float | Die Konversionsrate relativ zu den Öffnungen. | | `revenue` | float | Der Umsatz (nur für Ereignisse mit den Attributen `__amount` und `__currency`). | ##### Antwortbeispiel ``` { "metrics": [{ "timestamp": "2024-08-03 15:00:00", // Zeitstempel der Metriken im Format "YYYY-MM-DD HH:MM:SS" "platform": 3, // Plattformcode "sends": "55902", // Anzahl der gesendeten Nachrichten "opens": "382", // Anzahl der geöffneten Nachrichten "deliveries": "22931", // Anzahl der zugestellten Nachrichten "inbox_opens": "0", // Anzahl der im Posteingang geöffneten Nachrichten "unshowable_sends": "2", // Anzahl der Nachrichten, die nicht angezeigt werden konnten "errors": "0" // Anzahl der aufgetretenen Fehler }], "conversion": { "sends": "55902", // Gesamtanzahl der gesendeten Nachrichten "opens": "772", // Gesamtanzahl der geöffneten Nachrichten "events": [{ "name": "cart_add", // Name des Ereignisses "hits": "96", // Anzahl der Treffer für das Ereignis "conversion": 0.12, // Konversionsrate relativ zu den Öffnungen "revenue": 0 // Durch das Ereignis generierter Umsatz (nur für Ereignisse mit amount/currency-Attributen) }] } } ``` ## getMessageLog Zeigt detaillierte Informationen zu den gesendeten Nachrichten an. `POST` `https://api.pushwoosh.com/api/v2/statistics/getMessageLog` ##### Headers | Name
| Erforderlich
| Beschreibung
| |-----------------|----------|----------------------------------------------------------------------------------------------------------------------------| | `Authorization` | Erforderlich | [API-Zugriffstoken](/de/developer/api-reference/api-access-token/) aus dem Pushwoosh Control Panel. | ##### Parameter des Request-Body | Name
| Erforderlich
| Typ
| Beschreibung
| |--------------------|------------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `message_id` | Nein | Integer | Wählen Sie Nachrichtenereignisse anhand der Nachrichten-ID aus dem Nachrichtenverlauf aus. Beispiel: `12345678900`. | | `message_code` | Nein | String | Wählen Sie Nachrichtenereignisse anhand des [Nachrichtencodes](/de/developer/api-reference/api-identifiers/#message-code) aus, erhalten aus `/createMessage` API-Antworten. Beispiel: `"A444-AAABBBCC-00112233"`. | | `campaign_code` | Nein | String | Wählen Sie Nachrichtenereignisse anhand des [Kampagnencodes](/de/developer/api-reference/api-identifiers/#campaign-code) aus, der in Ihrer Nachrichten-Payload angegeben ist. Beispiel: `"AAAAA-XXXXX"`. | | `hwid` | Nein | String oder Array | Wählen Sie Nachrichtenereignisse anhand der [HWID (Hardware-ID)](/de/developer/api-reference/api-identifiers/#hardware-id) oder eines Arrays von HWIDs aus. | | `date_from` | Erforderlich, wenn `message_id`, `message_code` oder `campaign_code` nicht angegeben ist | Datetime | Startdatum zum Filtern von Nachrichten. Format: `"YYYY-MM-DD HH:MM:SS"`. Beispiel: `"2000-01-25 00:00:00"`. | | `date_to` | Erforderlich, wenn `message_id`, `message_code` oder `campaign_code` nicht angegeben ist | Datetime | Enddatum zum Filtern von Nachrichten. Format: `"YYYY-MM-DD HH:MM:SS"`. Beispiel: `"2000-01-26 00:00:00"`. | | `limit` | Nein | Integer | Maximale Anzahl von Nachrichtenereignissen, die in einer einzigen Antwort zurückgegeben werden. Maximalwert: `100000`. | | `pagination_token` | Nein | String | Paginierungstoken, erhalten aus einer vorherigen `/getMessageLog`-Antwort. Verwenden Sie es, um zusätzliche Ergebnisse abzurufen. | | `user_id` | Nein | String | Wählen Sie Nachrichtenereignisse anhand einer benutzerdefinierten [User ID](/de/developer/api-reference/api-identifiers/#user-id) aus. Siehe `/registerUser` für weitere Details. | | `application_code` | Ja | String | Wählen Sie Nachrichtenereignisse anhand des [Pushwoosh-Anwendungscodes](/de/developer/api-reference/api-identifiers/#application-code) aus. | | `actions` | Nein | Array | Filtern Sie Ergebnisse nach bestimmten Nachrichtenaktionen. Mögliche Werte: `"sent"`, `"delivered"`, `"opened"`, `"inbox_delivered"`, `"inbox_read"`, `"inbox_opened"`, `"inbox_deleted"`. | | `platforms` | Nein | Array | Array von Zielplattformen zum Filtern der Ergebnisse. Mögliche Werte: `"ios"`, `"android"`, `"osx"`, `"windows"`, `"amazon"`, `"safari"`, `"chrome"`, `"firefox"`, `"ie"`, `"email"`, `"huawei_android"`. | ##### Beispielanfrage ```shell curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/getMessageLog' \ --header 'Authorization: Key API_ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "pagination_token": "PAGINATION_TOKEN_FROM_PREVIOUS_RESPONSE", // optional, Token für Paginierung "limit": 1000, // optional, maximale Anzahl von Einträgen für eine einzelne Antwort "application_code": "XXXXX-XXXXX", // Pushwoosh-Anwendungscode "message_code": "A444-AAABBBCC-00112233", // optional, Nachrichtencode erhalten aus /createMessaage Anfrage "message_id": 1234567890, // optional, Nachrichten-ID erhalten aus dem Pushwoosh Control Panel "campaign_code": "AAAAA-XXXXX", // optional, Code einer Kampagne, für die das Protokoll abgerufen werden soll "hwid": "aaazzzqqqqxxx", // optional, Hardware-ID eines bestimmten Geräts, das mit einer Nachricht angesprochen wurde "user_id": "user_123", // optional, ID eines Benutzers, der mit der Nachricht angesprochen wurde "date_from": "2000-01-25 00:00:00", // optional, Beginn des Statistikzeitraums "date_to": "2000-02-10 23:59:59", // optional, Ende des Statistikzeitraums "actions": ["opened", "inbox_opened"], // optional, verwendet für Ergebnissfilterung. Mögliche Werte: "sent", "opened", "delivered", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". Die Antwort enthält alle Nachrichten mit den angegebenen Aktion(en). "platforms": ["ios", "chrome"] // optional, verwendet für Ergebnissfilterung. Mögliche Werte: "ios", "android", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "huawei android" }' ```
Antwortcodes und Beispiele ```json { "pagination_token": "PAGINATION_TOKEN_FOR_NEXT_REQUEST", "data": [{ "timestamp": "2000-01-25T11:18:47Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "sent", "status": "success", "push_alerts_enabled": "true" }, { "timestamp": "2000-01-25T11:18:49Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "delivered", "push_alerts_enabled": "true" }, { "timestamp": "2000-01-25T11:19:23Z", "application_code": "XXXXX-XXXXX", "message_id": 12345678900, "message_code": "A444-AAABBBCC-00112233", "campaign_code": "AAAAA-XXXXX", "hwid": "aaazzzqqqqxxx", "user_id": "user_123", "platform": "android", "action": "opened", "push_alerts_enabled": "true" }] } ``` ```json { "error": "exceeded the maximum date interval. Max interval: 30 days" } ``` ```json { "error": "account not found" } ```
## E-Mail-Statistiken ### linksInteractions Zeigt Statistiken zu Link-Klicks in E-Mails an. `POST` `https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions` ##### Headers | Name
| Erforderlich
| Beschreibung | |-----------------|----------|-------------------------------------------------------------------------------------------------------| | `Authorization` | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-access-token/) aus dem Pushwoosh Control Panel. | ##### Parameter des Request-Body | Name
| Erforderlich
| Typ | Beschreibung | |--------------------|----------|--------|------------------------------------------------------------------------------------------------------| | `date_range` | Nein | Object | Definiert den Berichtszeitraum. Enthält `date_from` und `date_to`. | | `filters` | Ja | Object | E-Mail-Filter. | | `application` | Ja | String | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) (alternativ können Sie `campaign`, `messages_ids` oder `message_codes` angeben). | | `messages_codes` | Ja | Array | [Nachrichtencodes](/de/developer/api-reference/api-identifiers/#message-code) (alternativ können Sie `application`, `campaign` oder `messages_ids` angeben). | | `campaign` | Ja | String | [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code) (alternativ können Sie `application`, `messages_ids` oder `message_codes` angeben). | | `messages_ids` | Ja | Array | Nachrichten-IDs (alternativ können Sie `application`, `campaign` oder `message_codes` angeben). | | `link_template` | Erforderlich, wenn `application` oder `campaign` angegeben ist. | String | Filtert E-Mail-Link-Interaktionen nach Stichwort. Nur Links, die den angegebenen Text in ihrer URL enthalten, werden in der API-Antwort zurückgegeben. Wenn Ihre E-Mail beispielsweise Links wie `https://example.com/news` und `https://example.com/shop` enthält, gibt die Einstellung "link_template": "shop" nur Interaktionen für `https://example.com/shop` zurück. | | `email_content_code` | Nein | String | [Eindeutige Kennung für den E-Mail-Inhalt](/de/developer/api-reference/api-identifiers/#email-content-code). | | `params` | Nein | Object | Definiert zusätzliche Antwortoptionen. Beinhaltet `with_full_links`, was eine Liste vollständiger Links mit Statistiken hinzufügt. | ##### Beispielanfrage ```shell curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions' \ --header 'Authorization: Api API_ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "filters": { "date_range": { "date_from": "string", // Erforderliches Format: 2000-01-01 "date_to": "string" // Erforderliches Format: 2000-01-01 }, "campaign": "string", // Kampagnencode (Sie können stattdessen application, messages_ids oder message_codes angeben) "application": "string", // Anwendungscode (Sie können stattdessen campaign, messages_ids oder message_codes angeben) "messages_ids": [], // Nachrichten-IDs (Sie können stattdessen application, campaign oder message_codes angeben) "messages_codes": [], // Nachrichtencodes (Sie können stattdessen application, campaign oder message_ids angeben) "link_template": "string", // Link-Vorlage (erforderlich, wenn application oder campaign angegeben ist) "email_content_code": "string" // Eindeutige Kennung für den E-Mail-Inhalt. }, "params": { "with_full_links": true // Geben Sie an, ob detaillierte Statistiken angezeigt werden sollen. Eine Liste der vollständigen Links mit Statistiken wird im Array full_links übergeben. } }' ``` ##### Antwortcodes und Beispiele ```json { "items": [{ "template": "string", "link": "string", "title": "string", "clicks": 0, "full_links": [{ "full_link": "string", "clicks": 0 }] }] } ``` ```json { "error": "exceeded the maximum date interval. Max interval: 30 days" } ``` ```json { "error": "account not found" } ``` ### linksInteractionsDevices Zeigt Benutzer an, die auf Links in E-Mails geklickt haben. `POST` `https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices` ##### Headers | Name
| Erforderlich
| Beschreibung | |-----------------|----------|------------------------------------------------------------------------------------------------------| | `Authorization` | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-access-token/) aus dem Pushwoosh Control Panel. | ##### Parameter des Request-Body | Name
| Erforderlich
| Typ | Beschreibung | |--------------------|----------|---------|------------------------------------------------------------------------------------------------------| | `date_range` | Nein | Object | Definiert den Berichtszeitraum. Enthält `date_from` und `date_to`. | | `filters` | Ja | Object | E-Mail-Filter. | | `application` | Ja | String | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) (alternativ können Sie `campaign`, `messages_ids` oder `message_codes` angeben). | | `messages_codes` | Ja | Array | [Nachrichtencodes](/de/developer/api-reference/api-identifiers/#message-code) (alternativ können Sie `application`, `campaign` oder `messages_ids` angeben). | | `campaign` | Ja | String | [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code) (alternativ können Sie `application`, `messages_ids` oder `message_codes` angeben). | | `messages_ids` | Ja | Array | Nachrichten-IDs (alternativ können Sie `application`, `campaign` oder `message_codes` angeben). | | `link_template` | Erforderlich, wenn `application` oder `campaign` angegeben ist. | String | Filtert E-Mail-Link-Interaktionen nach Stichwort. Nur Links, die den angegebenen Text in ihrer URL enthalten, werden in der API-Antwort zurückgegeben. Wenn Ihre E-Mail beispielsweise Links wie `https://example.com/news` und `https://example.com/shop` enthält, gibt die Einstellung "link_template": "shop" nur Interaktionen für `https://example.com/shop` zurück. | | `email_content_code` | Nein | String | [Eindeutige Kennung für den E-Mail-Inhalt](/de/developer/api-reference/api-identifiers/#email-content-code). | | `page` | Nein | Integer | Seitennummer für die Paginierung. | | `per_page` | Nein | Integer | Anzahl der Ergebnisse pro Seite (≤ 1000). | ##### Beispielanfrage ```shell curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices' \ --header 'Authorization: Api API_ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "filters": { "date_range": { "date_from": "string", // Erforderliches Format: 2000-01-01 "date_to": "string" // Erforderliches Format: 2000-01-01 }, "campaign": "string", // Kampagnencode (Sie können stattdessen application, messages_ids oder message_codes angeben) "application": "string", // Anwendungscode (Sie können stattdessen campaign, messages_ids oder message_codes angeben) "messages_ids": [], // Nachrichten-IDs (Sie können stattdessen application, campaign oder message_codes angeben) "messages_codes": [], // Nachrichtencodes (Sie können stattdessen application, campaign oder message_ids angeben) "link_template": "string", // Link-Vorlage (erforderlich, wenn application oder campaign angegeben ist) "email_content_code": "string" // Eindeutige Kennung für den E-Mail-Inhalt. }, "per_page": 100, "page": 0 }' ``` ##### Antwortcodes und Beispiele ```json { "total": 0, "items": [{ "timestamp": "string", "link": "string", "hwid": "string" }] } ``` ```json { "error": "exceeded the maximum date interval. Max interval: 30 days" } ``` ```json { "error": "account not found" } ``` ### bouncedEmails **POST** `https://api.pushwoosh.com/api/v2/statistics/emails/bouncedEmails` Liefert Daten zu E-Mail-Beschwerden, Soft Bounces und Hard Bounces, einschließlich Datum, E-Mail-Adresse und Grund für jeden Bounce. ##### Autorisierung Die Autorisierung erfolgt über das API-Zugriffstoken im Request-Header. ##### Parameter des Request-Body | Parametername | Typ | Beschreibung | Erforderlich | |----------------|--------|--------------------------------------------------------------------------------------------------|------------------------------------------------| | `application` | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) | Ja | | `message_code` | string | [Nachrichtencode](/de/developer/api-reference/api-identifiers/#message-code). | Erforderlich, wenn `date range` oder `campaign` nicht angegeben ist | | `campaign` | string | [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code). | Erforderlich, wenn `message_code` oder `date range` nicht angegeben ist | | `date_from` | string | Das Startdatum für die Daten im Format `YYYY-MM-DDTHH:MM:SS.000Z` (ISO 8601 Standard). | Erforderlich, wenn `message_code` oder `campaign` nicht angegeben ist | | `date_to` | string | Das Enddatum für die Daten im Format `YYYY-MM-DDTHH:MM:SS.000Z` (ISO 8601 Standard). | Erforderlich, wenn `message_code` oder `campaign` nicht angegeben ist | | `per_page` | int | Die Anzahl der Zeilen pro Seite, maximal 5000. | Ja | | `page` | int | Die Seitennummer, beginnend bei Null. | Ja | | `type` | string | Die Art des Bounces: Complaint, Softbounce, Hardbounce. | Nein | ##### Beispielanfrage ``` { "application": "XXXXX-XXXXX", // erforderlich. Pushwoosh-Anwendungscode "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // erforderlich, wenn campaign oder date range nicht angegeben ist. // Eindeutige Nachrichtenkennung "campaign": "XXXXX-XXXXX", // erforderlich, wenn message_code oder date range nicht angegeben ist. // Kampagnencode "date_from": "2024-07-20T00:00:00.000Z", // erforderlich, wenn message_code oder campaign nicht angegeben ist. // Startdatum im ISO 8601 Format "YYYY-MM-DDTHH:MM:SS.SSSZ" "date_to": "2024-07-20T00:00:00.000Z", // erforderlich, wenn message_code oder campaign nicht angegeben ist. // Enddatum im ISO 8601 Format "YYYY-MM-DDTHH:MM:SS.SSSZ" "per_page": 1000, // erforderlich. Anzahl der Ergebnisse pro Seite, maximal 5000 "page": 5, // optional. Seitennummer, beginnend bei Null "type": "Softbounce" // optional. Die Art des Bounces: Complaint, Softbounce, Hardbounce } ``` ##### Antwortfelder | Feldname | Typ | Beschreibung | |-------------------|--------|-----------------------------------------------------------------------------| | `total` | int | Die Gesamtanzahl der Zeilen. | | `bounced_emails` | array | Ein Array mit Details zu zurückgewiesenen E-Mails. | | ├── `email` | string | Die E-Mail-Adresse, die zurückgewiesen wurde. | | ├── `date` | string | Das Datum der Zurückweisung (Format: `YYYY-MM-DDTHH:MM:SS.000Z`). | | ├── `reason` | string | Der Grund für die Zurückweisung. | | └── `type` | string | Die Art der Zurückweisung: Complaint, Softbounce, Hardbounce. | ##### Antwortbeispiel ``` { "total": 25, // Gesamtanzahl der Zeilen. "bounced_emails": [{ "email": "example@example.com", // E-Mail-Adresse, die zurückgewiesen wurde "date": "2024-07-20T00:00:00.000Z", // Datum der Zurückweisung im ISO 8601 Format "reason": "Invalid recipient address", // Grund für die Zurückweisung "type": "Hardbounce" // Art der Zurückweisung: Complaint, Softbounce, Hardbounce }] } ```