# Push Logs

The Stream [Dashboard](https://dashboard.getstream.io/) includes logs that track the requests sent by Stream Chat API to Firebase or APN.

A new push log is created whenever the Stream API triggers the push delivery service, (i.e triggers the push delivery to provider(s) (Firebase/APN).

The API executes the push notification template and data template to APN or Firebase, and then relies on the provider to deliver the message to the device.

![](https://getstream.imgix.net/docs/Screenshot%202021-04-26%20at%2018.23.20.png?auto=compress&fit=clip&w=800&h=600)

## Chat Logs view & details

Log in to the [Dashboard](https://dashboard.getstream.io/) and access the Push Logs section through the Chat menu:

![](https://getstream.imgix.net/docs/Screenshot%202021-04-26%20at%2018.02.12.png?auto=compress&fit=clip&w=800&h=600)

Select **Push** , and your preferences (Push Provider, Log level, Period):

![](https://getstream.imgix.net/docs/Screenshot%202021-04-26%20at%2018.07.54.png?auto=compress&fit=clip&w=800&h=600)

The Logs include the

- **time** elapsed since the push happened

- **provider** for the push service

- **user ID** of the push receiver

- the **event type** that caused the push

- the **response status** from the provider

<admonition type="info">

The response status indicates whether the provider received the push and does not indicate whether the user's device successfully received it. If the dashboard shows response statuses and users are reporting failed pushes, the defect is between the Push Provider and the User's device.

</admonition>

When you select a log record, the dashboard shows extra details about the push.

![](https://getstream.imgix.net/docs/Screenshot%202021-04-26%20at%2017.30.41.png?auto=compress&fit=clip&w=800&h=600)

![](https://getstream.imgix.net/docs/Screenshot%202021-04-26%20at%2017.30.49.png?auto=compress&fit=clip&w=800&h=600)

## Log Errors

Errors for the

| Stream Error                              | Provider error                                    | Description                                                                                                                                                                                                                        |
| ----------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| NotRegistered - device is disabled ( 200) | Unregistered Device(200) + error:NotRegistered    | Wrong data/parameter                                                                                                                                                                                                               |
| Bad Device Token (400)                    | Authentication Error (401)                        | The specified device token is invalid. Verify that the request contains a valid token and that the token matches the environment. Common reason - device is registered with wrong token. E.g: iOS device configured with APN token |
| Bad Request Error (400)                   | Invalid Parameters(400) + error:InvalidParameters | Wrong data/parameter                                                                                                                                                                                                               |
| Auth Error (401)                          | Third Parrty Auth Error (401)                     | Bad configuration issue. APNs certificate or web push auth key was invalid or missing.                                                                                                                                             |
| Unknown Error (403)                       | Sender ID Mismatch or Internal error              | The authenticated sender ID is different from the sender ID for the registration token.                                                                                                                                            |
| Invalid Device Error (404)                | Unregistred Device (404)                          | Device is not registered.                                                                                                                                                                                                          |
| Resource Exhausted Error (429)            | isQuotaExceeded (429)                             | Quota or limit is reached, resource is exhausted.                                                                                                                                                                                  |
| Something bad (500)                       | Internal Error (500)                              | An unknown internal error occurred. The server encountered an error while trying to process the request.                                                                                                                           |

For more details, please refer to the response code documentation for the provider you are using:

- [Firebase](https://firebase.google.com/docs/reference/fcm/rest/v1/ErrorCode)

- [APN](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/handling_notification_responses_from_apns)

---

This page was last updated at 2025-08-15T14:15:05.991Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/python/push_logs/](https://getstream.io/chat/docs/python/push_logs/).