---
title: "Get current user's account"
method: GET
path: "/users/account"
---

# Get current user's account

`GET /users/account`

Get the authenticated user's account view: profile, status, earnings totals, last payout, and fan counts.

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

Current user's account details

- object
  - `uuid` string, uuid, required
  - `email` string, email, required
  - `handle` string, required
  - `displayName` string, required
  - `isCreator` boolean, required
  - `isAiCreator` boolean, required — Whether the account is an AI creator: an AI-generated persona rather than a human creator. Fanvue marks these with an "AI Generated" badge, so surface the same disclosure wherever you show the creator off-platform. Always false for non-creator accounts.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, nullable, required
  - `avatarUrl` string, nullable, required
  - `bannerUrl` string, nullable, required
  - `bio` string, required
  - `likesCount` number — Total likes the creator's content has received. Absent for non-creator accounts.
  - `contentCounts` object — Counts of the creator's posted content by media type. Absent for non-creator accounts.
    - `imageCount` number, required
    - `videoCount` number, required
    - `audioCount` number, required
    - `postCount` number, required
    - `payToViewPostCount` number, required
  - `account` object, required
    - `status` 'active' | 'suspended', required — Account lifecycle status
    - `subscriptionPrice` integer, nullable, required — Current monthly subscription price in USD cents (minor units), or null when no price is set (e.g. non-creator accounts). This is the creator's current setting, updatable via PATCH /users/me/subscription-price.
    - `earnings` object, required
      - `total` number, required — All-time gross earnings (sum of paid earning invoices), in USD cents
      - `availableBalance` number, required — Current available balance that can be withdrawn, in USD cents
      - `lastPayoutAt` string, date-time, nullable, required — Date of the most recent payout (paid_at), or null if there has been no payout
    - `fans` object, required
      - `followers` number, required — Number of contactable followers
      - `subscribers` number, required — Number of contactable active subscribers

## Other responses

- `400` — API version not supported
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

## Changes

- **2026-09-10** `4d08f36ad6c8` — 3 info
  - added the optional property `contentCounts` to the response with the `200` status
  - added the optional property `likesCount` to the response with the `200` status
  - added the required property `isAiCreator` to the response with the `200` status

[Change history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/users/account/get.md)

---

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