# 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 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. Ut vero quam aspernatur voluptatem.",
        "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

← General API resources Analytics →