Get My Profile

GET /v1/user

Returns the profile of the authenticated caller — the user the API key or token belongs to. There is no id in the path: this endpoint always resolves to "me".

This is an identity-only view: who you are, email + verification and MFA. It deliberately carries no plan, limits, payment-method, balance or retention — those are account properties (a user has no plan of its own under account-primary billing) and are served by GET /v1/account/plan and GET /v1/account. Internal security fields (password hash, session-revocation counters, fraud flags) are never returned.

Response (200 OK)

uuid string (uuid)
Your user's public id. Routes that name a user take it, e.g. /account/members/{user_uuid} and /stats/users/{uuid}.
username string
Login handle — equal to the account email (usernames are derived from the email at signup).
full_name string
The user's full name, collected at signup and editable in settings. May be empty.
email string
Current (verified) contact email.
email_verified boolean
Whether email has been verified.
pending_email string?
In-progress email change awaiting confirmation. Omitted when none is pending.
role string?
Elevated platform role (e.g. admin). Omitted for the default user.
status string
active | pending | suspended.
mfa_enabled boolean
Whether MFA is set up (hydrated from the MFA store).
created_at datetime
RFC 3339 UTC user creation timestamp.
last_login_at datetime?
Most recent successful login. Omitted for users that have never logged in.

Looking for plan, limits, payment method, balance or identity verification? Those are account-scoped: plan + limits at /account/plan, usage at /account/usage, the billing/account record at /account, and payment-method + KYC at /account/verification-status — all scoped to the request's active account.

Deprecated: until the sunset this response also carries the legacy integer id, and for legacy organisation users organization_id / current_org_context. Don't use them; read uuid.

Errors

401 Unauthorized
Missing or invalid auth.
Request
curl "https://api.ngris.com/v1/user" \ -H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") me = client.users.me() print(me.email, me.status) # plan/limits: client.users.get_plan()
Response — 200 OK
{ "uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "username": "alice@example.com", "full_name": "Alice Smith", "email": "alice@example.com", "email_verified": true, "status": "active", "mfa_enabled": false, "created_at": "2026-01-15T12:00:00Z", "last_login_at": "2026-04-29T08:15:00Z" }
Was this helpful?
On this page
Get My Profile
Was this helpful?
Homepage Docs Dashboard Docs API Docs nvelox Dashboard