Skip to main content
POST
/
v3
/
email-accounts
/
filter
Filter email accounts
curl --request POST \
  --url https://api.reply.io/v3/email-accounts/filter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "connected",
  "emailAccountType": "Gmail",
  "domains": [
    "company.com"
  ],
  "tags": [
    "Marketing"
  ]
}
'
{
  "items": [
    {
      "id": 12345,
      "ownerUserId": 42,
      "email": "john.doe@company.com",
      "senderName": "John Doe",
      "emailAccountType": "gmail",
      "isDefault": true,
      "dailyLimit": 500,
      "connectionStatus": "connected",
      "tags": [
        "Marketing"
      ]
    }
  ],
  "hasMore": false
}

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.

Query Parameters

​
top
integer

Maximum number of items to return (default 25, max 1000)

​
skip
integer

Number of items to skip

Body

application/json

Filter criteria for searching email accounts. All provided filters are combined with AND logic — an account must match every specified filter to be included. Omitted (null) filters are ignored.

​
status
enum<string> | null

Filter by connection status (case-insensitive, exact match). Allowed values: connected, disconnected, unknown

Available options:
connected,
disconnected,
unknown
​
emailAccountType
string | null

Filter by email account provider type (case-insensitive, exact match). Allowed values: Custom, Gmail, Outlook, Exchange, ExchangeOnPremise

​
email
string | null

Filter by email address (exact match, case-insensitive)

​
domains
string[] | null

Filter by email domains (suffix match on the email address). Multiple domains are combined with OR logic — matches any of the provided domains.

​
ownerUserIds
integer[] | null

Filter by owner user IDs (matches any of the provided IDs)

​
tags
string[] | null

Filter by tag names (case-insensitive, matches any of the provided tags)

Response

Paginated list of matching email accounts

​
items
EmailAccountListItem · object[]
​
hasMore
boolean

Whether more items are available beyond the current page