/history

Get a list of history records

Resource URL

GET https://api.emailjs.com/api/v1.1/history

Rate Limit

1 request per second

Parameters

NAME	REQUIRED	DESCRIPTION
user_id	Yes	Public Key of the account
accessToken	Yes	Private Key of the account
page	No	A current page
count	No	Records in one page
errors_only	No	Get only failed records

Response Information

Response formats is JSON or Text

Example Response

Success status:

{
  "is_last_page": true, // we don't have more records
  "rows": [
    {
      "id": "email_0537496c6cf98417e10eb2d8",
      "user_id": "YOUR_PUBLIC_KEY",
      "result": 1, // 1 is success
      "error": null,
      "provider": "Yandex",
      "service_id": "default_service",
      "original_service_id": "yandex",
      "template_id": "example_template",
      "template_params": "{\"user_os\":\"macOS Mojave\"}", // your stringify template params
      "files": "[]", // attachments list
      "retry_count": 0,
      "created_at": "2019-10-24T16:55:17.000Z",
      "updated_at": "2019-10-24T16:55:17.000Z"
    },
    {
      "id": "email_f1cb808c2545161b1a5fa4c4",
      "user_id": "YOUR_PUBLIC_KEY",
      "result": 2, // 2 is error,
      "error": "Zoho: Invalid login: 535 Authentication Failed", // error message
      "provider": "Zoho",
      "service_id": "zoho",
      "original_service_id": "zoho",
      "template_id": "example_template",
      "template_params": null,
      "files": "[]",
      "retry_count": 0,
      "created_at": "2019-09-26T13:08:05.000Z",
      "updated_at": "2019-09-26T13:08:05.000Z"
    }
  ]
}

Failure status:

400 "The user_id parameter is required"

Code Example

GET https://api.emailjs.com/api/v1.1/history?user_id=YOUR_PUBLIC_KEY&accessToken=YOUR_PRIVATE_KEY&page=1&count=50