daimon.email
Api referenceAccount

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

idstring

Unique account identifier (prefix: acc_)

tierstring

Current account tier: free, developer, growth, or enterprise

statusstring

Account status:

  • active - Normal operation
  • under_review - Flagged for abuse review, limited functionality
  • suspended - Account suspended, no operations allowed
api_keystring

API key with sensitive portion masked (last 24 characters hidden)

inbox_countnumber

Total number of inboxes created on this account

send_limitsobject

Sending limits for current tier:

  • daily - Maximum emails per day (0 for free tier)
  • monthly - Maximum emails per month (0 for free tier)
total_sentnumber

Total emails sent (lifetime)

total_bouncednumber

Total bounced emails (lifetime)

total_complaintsnumber

Total spam complaints (lifetime)

bounce_ratenumber

Bounce rate as percentage (0-100). Calculated as (total_bounced / total_sent) * 100

complaint_ratenumber

Complaint rate as percentage (0-100). Calculated as (total_complaints / total_sent) * 100

created_atstring

ISO 8601 timestamp of account creation

Tier Limits

TierDaily SendMonthly SendInboxesCustom DomainsSMTP Access
Free0 (receive-only)0UnlimitedNoNo
Developer1003,000Unlimited1Yes
Growth1,00030,000Unlimited5Yes
EnterpriseCustomCustomUnlimitedUnlimitedYes

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

401error

Invalid 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.