Skip to main content
POST
/
v3
/
reporting
/
emails
/
overview
Get email reporting overview
curl --request POST \
  --url https://api.reply.io/v3/reporting/emails/overview \
  --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": [
      "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"
    ]
  },
  "compareTo": {
    "from": "2025-12-01T00:00:00Z",
    "to": "2025-12-31T00:00:00Z"
  }
}
'
{
  "contacted": 123,
  "delivered": 123,
  "opened": 123,
  "replied": 123,
  "interested": 123,
  "notReached": 123,
  "optedOut": 123,
  "outOfOffice": 123,
  "bounced": 123,
  "autoReplied": 123,
  "meetingsBooked": 123,
  "accounts": 123,
  "deliveredPercentage": 123,
  "openedPercentage": 123,
  "repliedPercentage": 123,
  "interestedPercentage": 123,
  "notReachedPercentage": 123,
  "optedOutPercentage": 123,
  "outOfOfficePercentage": 123,
  "bouncedPercentage": 123,
  "autoRepliedPercentage": 123,
  "meetingsBookedPercentage": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

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.

Body

application/json

Request body for email overview reporting with optional comparison period

filters
Email Reporting Filters · object
required

Filters specific to email reporting endpoints

compareTo
object

Optional comparison period to calculate trends against

Response

Email overview with trends retrieved successfully

Email delivery and engagement metrics

contacted
integer

Number of people contacted

delivered
integer

Number of emails delivered

opened
integer

Number of emails opened

replied
integer

Number of emails replied to

interested
integer

Number of replies marked as interested

notReached
integer

Number of contacts not reached

optedOut
integer

Number of opt-outs

outOfOffice
integer

Number of out-of-office replies

bounced
integer

Number of bounced emails

autoReplied
integer

Number of auto-replies received

meetingsBooked
integer

Number of meetings booked from emails

accounts
integer | null

Total number of email accounts used

deliveredPercentage
number<double>

Delivery rate as a percentage (0–100)

openedPercentage
number<double>

Open rate as a percentage (0–100)

repliedPercentage
number<double>

Reply rate as a percentage (0–100)

interestedPercentage
number<double>

Interested rate as a percentage (0–100)

notReachedPercentage
number<double>

Not-reached rate as a percentage (0–100)

optedOutPercentage
number<double>

Opt-out rate as a percentage (0–100)

outOfOfficePercentage
number<double>

Out-of-office rate as a percentage (0–100)

bouncedPercentage
number<double>

Bounce rate as a percentage (0–100)

autoRepliedPercentage
number<double>

Auto-reply rate as a percentage (0–100)

meetingsBookedPercentage
number<double>

Meetings booked rate as a percentage (0–100)