Skip to main content
GET
/
api
/
v1
/
email-accounts
curl -X GET "https://api.foxreach.io/api/v1/email-accounts" \
  -H "X-API-Key: otr_your_key"

{
  "data": [
    {
      "id": "cea_abc123",
      "email": "[email protected]",
      "displayName": "John from Company",
      "provider": "gmail",
      "smtpHost": "smtp.gmail.com",
      "smtpPort": 587,
      "imapHost": "imap.gmail.com",
      "imapPort": 993,
      "dailyLimit": 50,
      "sentToday": 12,
      "warmupEnabled": true,
      "warmupDailyLimit": 10,
      "warmupRampUpDays": 14,
      "warmupStartDate": "2025-01-01T00:00:00",
      "healthScore": 95,
      "bounceRate": 0.02,
      "replyRate": 0.08,
      "isActive": true,
      "connectionStatus": "connected",
      "lastError": null,
      "createdAt": "2025-01-01T10:00:00",
      "updatedAt": "2025-01-15T10:30:00"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1
  }
}

​
Query Parameters

​
page
integer
default:"1"
Page number (starts at 1).
​
pageSize
integer
default:"20"
Number of accounts per page (1-100).

​
Response

​
data
array
Array of email account objects.
curl -X GET "https://api.foxreach.io/api/v1/email-accounts" \
  -H "X-API-Key: otr_your_key"

{
  "data": [
    {
      "id": "cea_abc123",
      "email": "[email protected]",
      "displayName": "John from Company",
      "provider": "gmail",
      "smtpHost": "smtp.gmail.com",
      "smtpPort": 587,
      "imapHost": "imap.gmail.com",
      "imapPort": 993,
      "dailyLimit": 50,
      "sentToday": 12,
      "warmupEnabled": true,
      "warmupDailyLimit": 10,
      "warmupRampUpDays": 14,
      "warmupStartDate": "2025-01-01T00:00:00",
      "healthScore": 95,
      "bounceRate": 0.02,
      "replyRate": 0.08,
      "isActive": true,
      "connectionStatus": "connected",
      "lastError": null,
      "createdAt": "2025-01-01T10:00:00",
      "updatedAt": "2025-01-15T10:30:00"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1
  }
}
Email account credentials (passwords) are never exposed through the API. To add or modify email accounts, use the dashboard.

​
Rate Limit

  • 100 requests per minute, per API key. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).
For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.