Skip to main content
POST
/
v3
/
reporting
/
emails
List email activity
curl --request POST \
  --url https://api.reply.io/v3/reporting/emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-03-01T00:00:00Z",
    "dateRangePreset": "lastWeek",
    "teamIds": [
      123
    ],
    "userIds": [
      123
    ],
    "contactListIds": [
      123
    ],
    "emailValidationStatuses": [],
    "companies": [
      "<string>"
    ],
    "companySizes": [],
    "industries": [
      "<string>"
    ],
    "cities": [
      "<string>"
    ],
    "states": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ],
    "titles": [
      "<string>"
    ],
    "sequenceIds": [
      123
    ],
    "includeOutOfSequence": false,
    "emailProviders": [],
    "emailAccountIds": [
      123
    ],
    "emailSendingSources": [],
    "bounceTypes": [],
    "sentiments": []
  }
}
'
{ "items": [ { "contactId": 123, "firstName": "<string>", "lastName": "<string>", "email": "jsmith@example.com", "company": "<string>", "emailAccountId": 123, "emailAccountEmail": "jsmith@example.com", "sequenceId": 123, "sequenceName": "<string>", "sequenceStepNumber": 123, "sequenceStepDisplayName": "<string>", "deliveryDate": "2023-11-07T05:31:56Z", "isDelivered": true, "isOpened": true, "isReplied": true, "isInterested": true, "isBounced": true, "isClicked": true, "isOptedOut": true } ], "hasMore": true }

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Query Parameters

​
top
integer

Number of records to return (page size)

Required range: x >= 1
​
skip
integer

Number of records to skip

Required range: x >= 0

Body

application/json
​
filters
Email Reporting Filters · object
required

Filters specific to email reporting endpoints

Response

Email list retrieved successfully

​
items
Email List Item · object[]
​
hasMore
boolean

Indicates if there are more items to fetch