# /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 User ID of the account
accessToken Yes Access Token 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_USER_ID",
      "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_USER_ID",
      "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=YOU_USER_ID&accessToken=YOUR_ACCESS_TOKEN&page=1&count=50