---
title: "Retrieve the current account"
method: GET
path: "/api/v1/me"
tags: ["Account"]
---

# Retrieve the current account

`GET /api/v1/me`

## Request

- Base URL: `https://api.sudomock.com`
- URL: `https://api.sudomock.com/api/v1/me`
- Auth: API key in header `x-api-key`

Returns account details, subscription info, usage statistics, and API key metadata for the authenticated user.

## Response `200`

Successful Response

- MeResponse: Your account, plan, usage and remaining credits.
  - `data` MeResponseData, required: Data payload in /me response
    - `account` MeAccountData, required: Account information in /me response
      - `uuid` string, required: User UUID
      - `email` string, required: User email address
      - `name` string, nullable: Account or company name
      - `created_at` string, date-time, required: Account creation timestamp
    - `organization` MeOrganizationData, required: Organization the request acts on in /me response
      - `id` string, required: Organization UUID
      - `name` string, required: Organization name
    - `subscription` MeSubscriptionData, required: Subscription information in /me response
      - `plan` string, required: Plan slug (e.g., 'pro-25k', 'scale-100k', 'free')
      - `tier` string, required: Plan tier for feature gating (e.g., 'free', 'pro', 'scale')
      - `status` string, required: Subscription status: 'active', 'cancelled', 'past_due', 'expired', 'paused'
      - `current_period_end` string, date-time, nullable: End of current billing period
      - `billing_channel` 'shopify' | 'stripe' | 'none': Which billing channel currently owns this subscription.
    - `usage` MeUsageData, required: Usage statistics in /me response
      - `credits_used_this_month` integer, required: Credits used in current billing period
      - `credits_limit` integer, required: Total credits available per month from plan
      - `credits_remaining` integer, required: Credits remaining (calculated)
      - `billing_period_start` string, date-time, required: Start of current billing period
      - `billing_period_end` string, date-time, required: End of current billing period
      - `prepaid_balance` number, required: Prepaid balance remaining, in prepaid_balance_currency. 0 when the account holds no balance (never null). Independent of the credits_* fields above, which count a subscription allotment.
      - `prepaid_balance_currency` string, required: ISO 4217 currency of prepaid_balance. Always USD today.
    - `api_key` MeApiKeyData: API key metadata in /me response
      - `name` string, required: API key name
      - `created_at` string, date-time, required: When the API key was created
      - `last_used_at` string, date-time, nullable: Last time the API key was used
      - `total_requests` integer, required: Total credit-consuming operations recorded for this API key
  - `success` boolean: Success status

---

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