All errors in an account can be retrieved with the /errors method.

Request url Methods Parameters
https://api.copernica.com/errors GET fields[]

Properties of an error

An error contains the following information:

  • ID (int, system field, cannot be edited)
  • timestamp (datetime, system field)
  • errorcode (string, smtp-code that was received)
  • description (string, description of code)
  • errortype (string, type of error)
  • errortypedescription (string, description of the type of error)
  • emailing (int, id of the emailing)
  • destination (int, id of the destination)
  • profile (int, id of the profile)
  • subprofile (int, id of the subprofile)

GET Request

Request information about the errors in an account.

The fields[] parameter can be included in the request URL to constrain the number of returned errors.

Example output

Upon a successful request, you will receive a message similar to the example below.

HTTP/1.1 200 OK
Date: Mon, 10 Feb 2014 12:25:37 GMT
Server: Apache/2.2.22(Ubuntu)
X-Powered-By: PHP/5.3.10 - 1ubuntu3.9
Content-Length: 2059
Content-Type: application/json

{
    "start":0,
    "limit":100,
    "total":50460,
    "data":[
        {
            "ID":"2121",
            "timestamp":"2005-01-14 16:34:35",
            "errorcode":"5.1.1",
            "description":"",
            "errortype":"other",
            "errortypedescription":"Niet gerubriceerde fouten",
            "emailing":"1717",
            "destination":"3779",
            "profile":null,
            "subprofile":"1621"
        },
        ...
    ]
}

Searching for errors with the GET request

By providing the fields[] GET parameter the results can be filtered. The field on which can be filtered is timestamp. The datetime format we use is YYYY-MM-DD HH:MM:SS and can look like 2014-08-01 10:40:31. With these GET parameters the url of a call could look like this:

/errors?fields[]=timestamp==2014-01-01 10:40:31&access_token=...

Further reading

Back to top of page