---
title: "Get current account details"
method: GET
path: "/api/me"
tags: ["Account"]
---

# Get current account details

`GET /api/me`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/me`
- Auth: HTTP bearer

Returns the authenticated user's account information including email, payment status, contact info status, referral code, and usage counts. Agents should call this after authentication to check `has_payment_method` and `has_contact` before attempting purchases.

## Response `200`

Account details

- AccountInfo
  - `id` string, required
  - `email` string, email, required
  - `plan` string, required: Active personal Domani plan key
  - `workspace_plans` string[], required: Distinct active Mailzero plan keys on workspaces the user can access
  - `has_payment_method` boolean, required: Whether the user has a card on file (required before buying domains)
  - `preferred_payment_method` 'card' | 'usdc', nullable, required
  - `preferred_locale` 'en' | 'fr' | 'es' | 'pt-BR' | 'ja' | 'zh-Hans' | 'it', required: Locale used by Domani interfaces and transactional communications
  - `has_contact` boolean, required: Whether the user has set WHOIS contact info. Optional for purchases (until it is set, Domani's contact holds new domains on the user's behalf), required before transferring a domain in.
  - `contact` RegistrantContact: WHOIS registrant contact information required for domain registration (ICANN requirement)
    - `first_name` string, required: First name
    - `last_name` string, required: Last name
    - `org_name` string, nullable: Organization name (optional)
    - `address1` string, required: Street address line 1
    - `address2` string, nullable: Street address line 2 (optional)
    - `city` string, required: City
    - `state` string, required: State or province
    - `postal_code` string, required: Postal/ZIP code
    - `country` string, required: ISO 3166-1 alpha-2 country code (e.g. US, GB, FR)
    - `phone` string, required: Phone in +CC.NUMBER format (e.g. +1.5551234567)
    - `email` string, email, required: Contact email address
  - `referral_code` string, required: Your unique referral code
  - `referral_rate` integer, required: Commission percentage on referred purchases
  - `balance` number: Marketplace credit balance in USD (earned from sales)
  - `domain_count` integer, required: Number of domains owned
  - `token_count` integer, required: Number of active API tokens
  - `features` string[]: Feature flags enabled for this account (GA features plus the preview features granted to the user), e.g. mailzero_assistant
  - `can_manage_assistant` boolean: Whether the calling token has the assistant:read scope. Independent of `features`: a feature flag says the account is eligible for the assistant, this says whether this specific token (full access, or a scoped CLI/OAuth/delegated token) may read or change its settings.
  - `is_admin` boolean
  - `mailbox_entitlement` object, required: Custom-domain mailbox room on the account's personal workspace. Its own plan, not `plan` above: a workspace can carry its own Mailzero subscription while the user's own plan stays free.
    - `plan_key` string, required: The plan governing mailboxes on the personal workspace (its own subscription if any, else the user's plan).
    - `mailbox_limit` integer, nullable, required: Custom-domain mailboxes the plan allows. null is unlimited.
    - `mailbox_limit_reached` boolean, required: True once the personal workspace is at its plan's mailbox limit.
    - `mailbox_upgrade_plan` object, nullable, required: The cheapest plan that would give room for another mailbox. null when already unlimited.
      - `key` string
      - `name` string
      - `priceUsd` number
      - `mailboxes` integer, nullable
  - `created_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)