Get Active Account
Returns the details and settings of your active account — the account your current API key or token is scoped to. Every request you make operates inside one active account; resources you create, list, and bill against all belong to it. Use /user/accounts to see every account you belong to and /user/switch-account to change which one is active.
The response also tells you your own role and ownership in this account, so a client can decide which management controls to show.
Response (200 OK)
An account object with the following fields:
id int64
Numeric account ID. This is the value you pass to /user/switch-account.
name string
Display name of the account.
owner_user_id int64
User ID of the account owner. The owner holds the plan, payment method, and full permissions.
plan_id int64
The plan the account is on. Drives the account's entitlements and limits. May be omitted on a free account with no explicit plan. See /account/billing.
subscription_status string
Subscription state for the account's plan (e.g.
active, trialing, past_due). Omitted when the account has no paid subscription.is_default bool
true for the account that was created automatically when you registered. Each user has exactly one default account.is_owner bool
true when you are the owner of this account.role_label string
Your role in this account —
"Owner", or the name of the custom role you were assigned.created_at, updated_at datetime
RFC 3339 timestamps for when the account was created and last modified.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account is selected on your token.
404 Not Found
The active account no longer exists.
Request
curl "https://api.ngris.com/v1/account" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
account = client.account.get()
print(account["name"], account["role_label"])
Response — 200 OK
{
"account": {
"id": 42,
"name": "Acme Engineering",
"owner_user_id": 1024,
"plan_id": 3,
"subscription_status": "active",
"is_default": false,
"is_owner": true,
"role_label": "Owner",
"created_at": "2026-04-01T09:00:00Z",
"updated_at": "2026-05-20T14:30:00Z"
}
}