Get current user (account info) | freecustom-email

{
  "success": true,
  "data": {
    "plan": "startup",
    "credits": 25000,
    "features": {
      "otp_extraction": false,
      "attachments": false,
      "max_attachment_size_mb": 6981,
      "custom_domains": true,
      "websocket": false,
      "max_ws_connections": 2137
    },
    "rate_limits": {
      "requests_per_second": 4688,
      "requests_per_month": 7214
    },
    "api_inboxes": [
      "string",
      "string"
    ],
    "api_inbox_count": 6946,
    "app_inboxes": [
      "string",
      "string"
    ],
    "app_inbox_count": 7852,
    "custom_domains": [
      {
        "domain": "mail.acme.com",
        "verified": true,
        "mx_record": "mx.freecustom.email",
        "txt_record": "freecustomemail-verification=a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
        "added_at": "2026-01-15T10:00:00.000Z"
      },
      {
        "domain": "mail.acme.com",
        "verified": true,
        "mx_record": "mx.freecustom.email",
        "txt_record": "freecustomemail-verification=a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
        "added_at": "2026-01-15T10:00:00.000Z"
      }
    ],
    "custom_domain_count": 6778
  }
}

Returns the authenticated developer’s account info — plan, rate limits, feature flags, inbox count, credit balance, and custom domain count.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response headers

X-API-PlanstringOptional

X-RateLimit-Limit-SecondstringOptional

X-RateLimit-Remaining-SecondstringOptional

X-RateLimit-Limit-MonthstringOptional

X-RateLimit-Remaining-MonthstringOptional

Response

successboolean

dataobject

Errors

401

Unauthorized Error

429

Too Many Requests Error

$	curl https://api2.freecustom.email/v1/me \
>	-H "Authorization: Bearer <token>"