Account

API reference for credits, today's campaign limit and what's left of it, and warm-up.

Using an AI agent? Just ask:“How many credits do I have, and how many campaign emails can I still send today?”Connect your agent →

Get account#

GET/api/v1/account

Credits left, whether the workspace can send, today's campaign limit with how much of it is left, and the warm-up step for new accounts. Check it before a big campaign.

Request

curl https://maillayer.com/api/v1/account \
  -H "Authorization: Bearer $MAILLAYER_KEY"

Response · 200

{
  "name": "Acme",
  "status": "active",
  "paused_reason": null,
  "credits": 9420,
  "can_send": true,
  "free_tests_left": null,
  "campaigns": {
    "daily_limit": 5000,
    "sent_today": 1200,
    "left_today": 3800,
    "resets_at": "2026-11-15T00:00:00.000Z",
    "note": "A campaign bigger than what's left today keeps going on the following days by itself."
  },
  "transactional": { "daily_limit": null, "requests_per_minute": 300 },
  "warm_up": {
    "step": 2,
    "of": 4,
    "next_daily_limit": 20000,
    "next_after_clean_emails": 2000,
    "next_by": "2026-11-21T10:04:00.000Z",
    "held": null
  }
}

warm_up is null once the account is past warm-up. held explains why it isn't stepping up, such as too many bounces. Transactional email has no daily limit, only the API rate limit. See Deliverability for how warm-up works.