---
title: "Retrieve current user details"
method: GET
path: "/users/me"
tags: ["Users"]
---

# Retrieve current user details

`GET /users/me`

Retrieves information about the currently authenticated Neon user,
including account identifiers, plan details, and linked auth accounts.

## Response `200`

Returned information about the current user

- CurrentUserInfoResponse
  - `active_seconds_limit` integer, required — Control plane observes active endpoints of a user this amount of wall-clock time.
  - `billing_account` BillingAccount
    - `state` 'UNKNOWN' | 'active' | 'suspended' | 'deactivated' | 'deleted', required — State of the billing account.
    - `payment_source` PaymentSource, required
      - `type` string, required — Type of payment source. E.g. "card".
      - `card` PaymentSourceBankCard
        - `last4` string, required — Last 4 digits of the card.
        - `brand` 'amex' | 'diners' | 'discover' | 'jcb' | 'mastercard' | 'unionpay' | 'unknown' | 'visa' — Brand of credit card.
        - `exp_month` integer — Credit card expiration month
        - `exp_year` integer — Credit card expiration year
    - `subscription_type` 'UNKNOWN' | 'direct_sales' | 'direct_sales_v3' | 'aws_marketplace' | 'free_v2' | 'free_v3' | 'launch' | 'launch_v3' | 'scale' | 'scale_v3' | 'business' | 'vercel_pg_legacy', required — Type of subscription to Neon Cloud. Notice that for users without billing account this will be "UNKNOWN"
    - `payment_method` 'UNKNOWN' | 'none' | 'stripe' | 'direct_payment' | 'aws_mp' | 'azure_mp' | 'vercel_mp' | 'staff' | 'trial' | 'sponsorship' | 'shared_payment_token', required — Indicates whether and how an account makes payments.
    - `quota_reset_at_last` string, date-time, required — The last time the quota was reset. Defaults to the date-time the account is created.
    - `name` string, required — The full name of the individual or entity that owns the billing account. This name appears on invoices.
    - `email` string, email, required — Billing email, to receive emails related to invoices and subscriptions.
    - `address_city` string, required — Billing address city.
    - `address_country` string, required — Billing address country code defined by ISO 3166-1 alpha-2.
    - `address_country_name` string — Billing address country name.
    - `address_line1` string, required — Billing address line 1.
    - `address_line2` string, required — Billing address line 2.
    - `address_postal_code` string, required — Billing address postal code.
    - `address_state` string, required — Billing address state or region.
    - `orb_portal_url` string — Orb user portal url
    - `tax_id` string — The tax identification number for the billing account, displayed on invoices.
    - `tax_id_type` string — The type of the tax identification number based on the country.
    - `plan_details` PlanDetails
      - `name` string, required
      - `version` PlanVersion
        - `major` integer, required
        - `minor` integer, required
    - `spending_limit_cents` integer, nullable — Monthly spending cap in cents for V3 paid plans. When set, notifications are sent at 80% and 100% of this limit. `null` means no limit is configured.
  - `auth_accounts` CurrentUserAuthAccount[], required
    - `email` string, email, required
    - `image` string, required
    - `login` string, required — DEPRECATED. Use `email` field.
    - `name` string, required
    - `provider` 'github' | 'google' | 'hasura' | 'microsoft' | 'microsoftv2' | 'vercelmp' | 'keycloak', required — Identity provider id from keycloak
  - `email` string, email, required
  - `id` string, required
  - `image` string, required
  - `login` string, required — DEPRECATED. Use `email` field.
  - `name` string, required
  - `last_name` string, required
  - `projects_limit` integer, required
  - `branches_limit` integer, required
  - `max_autoscaling_limit` number, double, required — The maximum autoscaling limit in Compute Units. A value of 0 indicates no limit is configured.
  - `compute_seconds_limit` integer
  - `plan` string, required

## Other responses

- `default` — General Error. The request may or may not be safe to retry, depending on the HTTP method, response status code, and whether a response was received. - If no response is returned from the API, a network error or timeout likely occurred. - In some cases, the request may have reached the server and been successfully processed, but the response failed to reach the client. As a result, retrying non-idempotent requests can lead to unintended results. The following HTTP methods are considered non-idempotent: `POST`, `PATCH`, `DELETE`, and `PUT`. Retrying these methods is generally **not safe**. The following methods are considered idempotent: `GET`, `HEAD`, and `OPTIONS`. Retrying these methods is **safe** in the event of a network error or timeout. Any request that returns a `503 Service Unavailable` response is always safe to retry. Any request that returns a `423 Locked` response is safe to retry. `423 Locked` indicates that the resource is temporarily locked, for example, due to another operation in progress.

---

[API](https://skmtc.net/neon/apis/neon-api.md) · [All operations](https://skmtc.net/neon/apis/neon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neon/neon-api/revisions/cfde79a5c713/schema)