> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foxreach.io/llms.txt
> Use this file to discover all available pages before exploring further.
# List Email Accounts
> Retrieve a paginated list of email accounts in your workspace.
## Query Parameters
Page number (starts at 1).
Number of accounts per page (1-100).
## Response
Array of email account objects.
Unique account identifier.
Email address.
Display name for outgoing emails.
Email provider: `gmail`, `outlook`, `custom`.
SMTP server hostname.
SMTP port.
IMAP server hostname.
IMAP port.
Maximum emails per day.
Emails sent today.
Whether warmup is enabled.
Warmup emails per day.
Days for warmup ramp-up.
When warmup started.
Account health score (0-100).
Bounce rate (0.0-1.0).
Reply rate (0.0-1.0).
Whether the account is active.
Connection status: `connected`, `disconnected`, `error`.
Last error message if any.
ISO 8601 timestamp.
ISO 8601 timestamp.
```bash cURL theme={null}
curl -X GET "https://api.foxreach.io/api/v1/email-accounts" \
-H "X-API-Key: otr_your_key"
```
```python Python SDK theme={null}
from foxreach import FoxReach
client = FoxReach(api_key="otr_your_key")
accounts = client.email_accounts.list()
```
```typescript TypeScript SDK theme={null}
import { FoxReach } from "foxreach";
const client = new FoxReach({ apiKey: "otr_your_key" });
const accounts = await client.emailAccounts.list();
```
```json theme={null}
{
"data": [
{
"id": "cea_abc123",
"email": "outreach@company.com",
"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](/rate-limiting).