# Activity

Get information about your domain activity, including your sent emails, and whether they were received by the recipient. You can also see whether they opened or clicked on any of the email content.

# Get a list of activities

With this endpoint, you can get every single data point of the activity that happened for a specific domain.

Get a list of activities with this GET request:

GET https://api.mailersend.com/v1/activity/{domain_id}

# Request parameters

URL parameter Type Required Limitations Details
domain_id string yes
Query parameter Type Required Limitations Details
page int no
limit int no Min: 10, Max: 100 Default: 25
date_from int no Timestamp is assumed to be UTC. Must be lower than date_to Format: 1443651141
date_to int no Timestamp is assumed to be UTC. Must be higher than date_from Format: 1443651141
event[] string[] no Possible types: processed,queued,sent,delivered,soft_bounced,
hard_bounced,junk,opened,clicked,unsubscribed,
spam_complaints

# Responses

# Valid

Response Code: 200 OK
Response Headers:
	Content-Type: application/json
{
	"data" : [
		{
      "id": "5ee0b166b251345e407c9207",
      "created_at": "2020-06-04 12:00:00",
      "updated_at": "2020-06-04 12:00:00",
      "type": "clicked",
      "email": {
        "id": "5ee0b166b251345e407c9201",
        "from": "colleen.wiza@example.net",
        "subject": "Magni aperiam sunt nam omnis.",
        "text": "Perferendis iure deleniti itaque occaecati mollitia quis aliquid.",
        "html": "<html></html>",
        "status": "sent",
        "tags": null,
        "created_at": "2020-06-04 12:00:00",
        "updated_at": "2020-06-04 12:00:00",
        "recipient": {
          "id": "5ee0b166b251345e407c9200",
          "email": "tyra.cummerata@example.org",
          "created_at": "2020-06-04 12:00:00",
          "updated_at": "2020-06-04 12:00:00",
          "deleted_at": ""
        }
      }
    },
	],
	"links": {
    "first": "http:\/\/www.mailersend.io\/api\/v1\/activity\/8jk1o5?page=1",
    "last": "http:\/\/www.mailersend.io\/api\/v1\/activity\/8jk1o5?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "http:\/\/www.mailersend.io\/api\/v1\/activity\/8jk1o5",
    "per_page": 25,
    "to": 1,
    "total": 1
  }
}

# Error

Response Code: 422 Unprocessable Entity

See - Validations errors

Last updated: 11/29/2021, 1:49:54 PM