Get Account
Retrieve account details, tier, and usage statistics
Authentication
Account API Key required via Authorization: Bearer {api_key} header.
curl -X GET https://api.daimon.email/v1/account \
-H "Authorization: Bearer dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o"import { DaimonClient } from 'daimon-email';
const client = new DaimonClient({
apiKey: 'dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o'
});
const account = await client.account.get();
console.log(`Tier: ${account.tier}`);
console.log(`Status: ${account.status}`);
console.log(`Inboxes: ${account.inbox_count}`);
console.log(`Total sent: ${account.total_sent}`);
console.log(`Bounce rate: ${account.bounce_rate}%`);from daimon_email import DaimonClient
client = DaimonClient(api_key='dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o')
account = client.account.get()
print(f"Tier: {account.tier}")
print(f"Status: {account.status}")
print(f"Inboxes: {account.inbox_count}")
print(f"Total sent: {account.total_sent}")
print(f"Bounce rate: {account.bounce_rate}%")Response
{
"result": {
"id": "acc_def456",
"tier": "free",
"status": "active",
"api_key": "dm_free_7d8a9b0c1d2e3f*********************",
"inbox_count": 3,
"send_limits": {
"daily": 0,
"monthly": 0
},
"total_sent": 0,
"total_bounced": 0,
"total_complaints": 0,
"bounce_rate": 0.0,
"complaint_rate": 0.0,
"created_at": "2024-03-10T09:15:22Z"
},
"next_steps": [
"Use GET /v1/capabilities to see what actions are available at your tier",
"Use POST /v1/upgrade-link to generate an upgrade link for paid features",
"Monitor bounce_rate and complaint_rate - high rates may trigger account review"
]
}Response Fields
idstringUnique account identifier (prefix: acc_)
tierstringCurrent account tier: free, developer, growth, or enterprise
statusstringAccount status:
active- Normal operationunder_review- Flagged for abuse review, limited functionalitysuspended- Account suspended, no operations allowed
api_keystringAPI key with sensitive portion masked (last 24 characters hidden)
inbox_countnumberTotal number of inboxes created on this account
send_limitsobjectSending limits for current tier:
daily- Maximum emails per day (0 for free tier)monthly- Maximum emails per month (0 for free tier)
total_sentnumberTotal emails sent (lifetime)
total_bouncednumberTotal bounced emails (lifetime)
total_complaintsnumberTotal spam complaints (lifetime)
bounce_ratenumberBounce rate as percentage (0-100). Calculated as (total_bounced / total_sent) * 100
complaint_ratenumberComplaint rate as percentage (0-100). Calculated as (total_complaints / total_sent) * 100
created_atstringISO 8601 timestamp of account creation
Tier Limits
| Tier | Daily Send | Monthly Send | Inboxes | Custom Domains | SMTP Access |
|---|---|---|---|---|---|
| Free | 0 (receive-only) | 0 | Unlimited | No | No |
| Developer | 100 | 3,000 | Unlimited | 1 | Yes |
| Growth | 1,000 | 30,000 | Unlimited | 5 | Yes |
| Enterprise | Custom | Custom | Unlimited | Unlimited | Yes |
Account Health
Warning
High bounce/complaint rates trigger review: If bounce_rate exceeds 5% or complaint_rate exceeds 0.1%, your account may be placed under_review. During review, sending is restricted.
Monitor these metrics regularly:
const account = await client.account.get();
if (account.bounce_rate > 5) {
console.warn('Bounce rate is high - review your recipient lists');
}
if (account.complaint_rate > 0.1) {
console.warn('Complaint rate is high - ensure recipients opted in');
}
if (account.status === 'under_review') {
console.error('Account is under review - contact support');
}Error Responses
401errorInvalid or missing API key
Info
Pro tip: Check /v1/capabilities instead of parsing tier limits manually. The capabilities endpoint provides a dynamic, agent-friendly view of what's currently allowed.