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, MFA, KYC and organisation context. 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)

id int64

Numeric user ID.

username string

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).

organization_id, current_org_context int64

Owning organisation and the org the session is currently acting in. Omitted for non-org users.

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 + usage at /account/plan, the billing/account record at /account, and payment-method + KYC at /account/verification-status — all scoped to the request's active account.

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.account.plan()

Response — 200 OK
{
  "id": 1024,
  "username": "alice",
  "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"
}

PreviousResend Verification Email NextUpdate My Profile

On this page

Get My Profile