Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
 
 
Cannot retrieve contributors at this time

REST API: GET abuses (Marketing Suite)

Each emailing is tracked, which allows Copernica to provide you with emailing statistics. Abuses are one of these statistics. You can retrieve all abuses for an account by sending an HTTP GET call to the following URL:

https://api.copernica.com/v3/ms/abuses?access_token=xxxx

Parameters

The parameters for this method can be set to retrieve the statistics from a certain period. The following optional parameters are available:

  • begintime: The timestamp after which the abuses must have occurred (YYYY-MM-DD HH:MM:SS format).
  • endtime: The timestamp before which the abuses must have occurred (YYYY-MM-DD HH:MM:SS format).

Returned fields

The method returns a JSON object with several abuses under the 'data' property. For each abuse the following information is available:

  • ID: The ID of the abuse.
  • mailing: The ID of the mailing.
  • timestamp: Timestamp of the abuse.
  • report: The abuse report.
  • destination: The ID of the destination that reported the abuse.
  • profile: The ID of the profile that reported the abuse.
  • subprofile: The ID of the subprofile that reported the abuse.

JSON example

A single abuse might look something like this:

{  
   "ID":"12",
   "mailing":"233482",
   "timestamp":"2019-03-05 14:44:52",
   "report":{  

   },
   "destination":"1264524",
   "profile":null,
   "subprofile":null
}

PHP example

This script demonstrates how to use this API method:

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

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

// execute the call
print_r($api->get("ms/abuses"));

This example requires the REST API class.

More information