Skip to main content
POST
/
reporting
/
emails
List email activity
curl --request POST \
  --url https://api.reply.io/v3/reporting/emails \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "filters": {
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-03-01T00:00:00Z",
    "dateRangePreset": "LastWeek",
    "teamIds": [
      123
    ],
    "userIds": [
      123
    ],
    "contactListIds": [
      123
    ],
    "emailValidationStatuses": [
      "RequiresValidation"
    ],
    "companies": [
      "<string>"
    ],
    "companySizes": [
      "Empty"
    ],
    "industries": [
      "<string>"
    ],
    "cities": [
      "<string>"
    ],
    "states": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ],
    "titles": [
      "<string>"
    ],
    "sequenceIds": [
      123
    ],
    "includeOutOfSequence": false,
    "emailProviders": [
      "None"
    ],
    "emailAccountIds": [
      123
    ],
    "emailSendingSources": [
      "SequenceProcessing"
    ],
    "bounceTypes": [
      "Unknown"
    ],
    "sentiments": [
      "Unknown"
    ]
  }
}
'
{
  "data": [
    {
      "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
    }
  ],
  "iterationInfo": {
    "hasMore": true
  }
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

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

data
Email List Item · object[]
iterationInfo
Iteration Info · object

Metadata about iterated resource