Home > Documentation > REST API v4: GET push notifications

REST API v4: GET push notifications

This method retrieves all sent push notifications available within the account.

To retrieve the sent push notifications, send an HTTP GET request to the following URL:

https://api.copernica.com/v4/push/notifications

Returned fields

This method returns a collection of push notifications.

Name Description
ID Unique identifier of the push notification.
timestamp Date and time when the push notification was sent.
title Title of the push notification.
destinations Number of recipients targeted by the push notification.
channel Channel through which the push notification was sent, for example web or mobile.
fallback Optional fallback content used when the primary channel is not available.
target Information about the target of the push notification.
target.type Type of target to which the push notification was sent.
target.sources The underlying sources that make up the target.
target.sources[].id ID of the source.
target.sources[].type Type of source, for example profile, subprofile, view or database.

JSON example

The JSON response looks like the following:

{
    "ID": "1",
    "timestamp": "2026-06-04 13:37:04",
    "title": "testing push",
    "destinations": 0,
    "channel": "web",
    "fallback": "",
    "target": {
        "type": "view",
        "sources": [
            {
                "id": "5",
                "type": "view"
            },
            {
                "id": "2",
                "type": "database"
            }
        ]
    }
}

In the example above, the push notification was sent to a view. The view is part of database 2 and has ID 5.

PHP example

The following script demonstrates how to use this API method.

// required scripts
require_once("CopernicaRestAPI.php");

// change this to your access token
$api = new CopernicaRestAPI("your-access-token", 4);

// execute the request
$api->get("push/notifications");

This example requires the REST API class.