Get current user (account info) | freecustom-email

import requests
url = "https://api2.freecustom.email/v1/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

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

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-Planstring

X-RateLimit-Limit-Monthstring

X-RateLimit-Limit-Secondstring

X-RateLimit-Remaining-Monthstring

X-RateLimit-Remaining-Secondstring

Response

dataobject

successboolean

Errors

401

Unauthorized Error

429

Too Many Requests Error