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 retrieve every single data point of the activity that happened for a specific domain.

Obtain a list of activities with the following 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

1
2
3

{
	"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": "https:\/\/api.mailersend.com\/v1\/activity\/8jk1o5?page=1",
    "last": "https:\/\/api.mailersend.com\/v1\/activity\/8jk1o5?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "path": "https:\/\/api.mailersend.com\/api\/v1\/activity\/8jk1o5",
    "per_page": 25,
    "to": 1
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

Error

Response Code: 422 Unprocessable Entity

See - Validations errors

# Activity

# Get a list of activities

# Request parameters

# Responses