Home > Documentation > REST API v2: GET documents (Publisher template)

REST API v2: GET documents (Publisher template)

You can use the REST API to retrieve a all emailing documents belonging to a template with an HTTP GET call to the following URL:

https://api.copernica.com/v2/publisher/template/$id/documents?access_token=xxxx

Where $id should be replaced with the ID of the emailing template you want to retrieve the emailing documents for.

Returned fields

The method returns a JSON object where the *data field contains an array with emailing documents. Each document contains the following information:

  • id: The ID of the document.
  • template: The ID of the corresponding template.
  • name: The name of the document.
  • from_address: The from address for the document.
  • subject: The subject of the document.
  • archived: The archive status of the document. (1 for archived, null for not archived)
  • source: The source of the document.

JSON example

The JSON for the document might look something like this:

{  
   "id":"79",
   "template":"31",
   "name":"Hallo",
   "from_address":"\"test\" <test@copernica.nl>",
   "subject":"test",
   "archived":null,
   "source":"<html><head><title>Title</title></head><body><p>Paragraph</p></body></html>"
}

PHP example

The script below demonstrates how to use this API method. Don't forget to replace the ID in the URL before executing the call.

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

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

// execute the call
print_r($api->get("publisher/template/{$templateID}/documents"));

This example requires the REST API class

More information