GET https://emailoctopus.com/api/1.5/campaigns/:campaignId/reports/not-opened
Get information on the contacts who didn't open the campaign.
Parameters |
api_key (string)
|
Your API key.
|
limit (integer)
|
The number of records to return per page, up to a maximum of 100. Defaults to 100.
|
200 (Success) Returns |
data (array of structs)
|
The contacts that didn't open:
contact (struct)
|
Details of the contact:
id (string)
|
The identifier of the contact.
|
email_address (string)
|
The email address of the contact.
|
fields (object)
|
An object containing key/value pairs of field values, using the field's tag as the key.
|
status (string)
|
The status of the contact (SUBSCRIBED, UNSUBSCRIBED or PENDING).
|
deleted (boolean)
|
If the contact has since been deleted.
If `true`, all other fields apart from `id` will be NULL.
|
created_at (string)
|
When the contact was created, in ISO 8601 format.
|
|
|
paging (array)
|
URLs to navigate the results:
next (nullable string)
|
A link for the immediate next page of results.
|
|
Non-200 (Error) Returns |
Details of the error:
code (string)
|
The error code.
|
message (string)
|
A description of the error.
|
|
Method-specific Error Codes |
CAMPAIGN_NOT_FOUND
|
The campaign could not be found.
|
CAMPAIGN_NOT_SENT
|
The campaign does not have a status of 'SENT'.
|
API-wide Error Codes |
INVALID_PARAMETERS
|
Parameters are missing or invalid.
|
API_KEY_INVALID
|
Your API key is invalid.
|
UNAUTHORISED
|
You're not authorised to perform that action.
|
NOT_FOUND
|
The requested endpoint does not exist.
|
UNKNOWN
|
An unknown error has occurred.
|
Example Request |
/api/1.5/campaigns/00000000-0000-0000-0000-000000000000/reports/not-opened?api_key=00000000-0000-0000-0000-000000000000
|
Example Response |
{
"data": [
{
"contact": {
"id": "00000000-0000-0000-0000-000000000000",
"email_address": "john.doe@example.com",
"fields": {
"FirstName": "John",
"LastName": "Doe"
},
"status": "SUBSCRIBED",
"created_at": "2019-02-17T00:00:00+00:00"
}
},
{
"contact":
{
"id": "00000000-0000-0000-0000-000000000001",
"email_address": "jane.doe@example.com",
"fields": {
"FirstName": "Jane",
"LastName": "Doe"
},
"status": "SUBSCRIBED",
"created_at": "2019-02-17T00:00:00+00:00"
}
}
],
"paging": {
"next": null,
"previous": null
}
}
|