Home > Documentation > REST API v4: GET JSON logfiles

REST API v4: GET JSON logfiles

Copernica keeps logfiles which you can request with the API. This method can be used to download a logfile as JSON using its filename. If you don't know the filename please see "More information" for instructions. To execute the method you can send an HTTP GET request to the following URL:

https://api.copernica.com/v4/logfile/$filename/json

where $filename is the name of the file you want to request.

Available parameters

The following parameters can be added to the URL as query variables:

  • from: unix timestamp indicating the point in time from which the logfile should be read. Only log entries with a timestamp after this value will be returned. Note: this parameter is only available via the endpoint https://rest.copernica.com and does not work with https://api.copernica.com.

Example

In the example below, only log entries from the specified timestamp are returned.

https://rest.copernica.com/v4/logfile/cdm-impression.2026-03-24.log/json?from=1774389600

Returned value

A JSON representation of the requested log file. An example of such a logfile is shown below.

[
    {
        "id":"XXXXXXXXXX1",
        "time":"2016-11-04 11:01:00",
        "mailingid":12345,
        "profileid":1111111,
        "subprofileid":2,
        "databaseid":133,
        "collectionid":0,
        "senderdomain":
        "copernica.com",
        "templateid":1234,
        "tags":"",
        "email":"employee1234@copernica.com"
    },
    {
        "id":"XXXXXXXXXX2",
        "time":"2016-11-04 11:06:00",
        "mailingid":12345,
        "profileid":1111111,
        "subprofileid":2,
        "databaseid":133,
        "collectionid":0,
        "senderdomain":"copernica.com",
        "templateid":1234,
        "tags":"",
        "email":"employee1235@copernica.com"
    },
        ...
]

PHP Example

The following PHP script demonstrates how to use the API method. Don't forget to substitute the filename in the URL. An example of such a filename is cdm-attempts.2016-11-04.log to retrieve all delivery attemps made on the 4th of November 2016.

// dependencies
require_once('CopernicaRestAPI.php');

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

// do the call, and print result
print_r($api->get("logfile/{$filename}/json"));

The example above requires the CopernicaRestApi class.

More information