---
title: "Get account details"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account details

`GET /v1/account`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/account`
- Auth: HTTP bearer

Returns the authenticated account's details including limits and configuration.

## Response `200`

Account details

- AccountResponse
  - `data` object
    - `id` string: Account ID
    - `name` string: Account name
    - `email` string: Account owner email
    - `plan` string: Current plan name (e.g. "Startup", "Enterprise")
    - `domains_limit` integer: Maximum number of domains allowed
    - `domains_used` integer: Number of domains currently in use
    - `domain_credits` integer: Domain credits available (each credit covers one domain purchase)
    - `email_users_limit` integer: Maximum number of email users allowed
    - `email_users_used` integer: Number of email users currently in use
    - `stripe_subscription_status` string: Subscription status (e.g. "active", "canceled", "past_due")
    - `prewarmed_subscription_status` string, nullable: Status of the standalone pre-warmed ($3/addr) subscription, if any
    - `prewarmed_domains_disabled` boolean: True while pre-warmed domains are suspended for non-payment
    - `universal_inbox_enabled` boolean: Whether inbox sync (the Universal Inbox) is on. Change it with POST /v1/account/universal-inbox.
    - `api_token` object: Present only when the request is authenticated with an API token. Describes the calling token itself so integrations can discover their own scope (the Winnr MCP server hides write tools when `permissions` lacks "write").
      - `id` string: Token ID
      - `name` string, nullable: Token name as set at creation
      - `permissions` string[]
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Authentication required or token invalid

---

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