User Stats
GET
/v1/stats/users/{uuid}
Aggregate stats for the requested user — tunnel/endpoint counts, cumulative and current-period byte/request counters, and the account's effective limits. Pass your own user uuid (from GET /v1/user).
Account scope: for non-admin callers the figures are the account aggregate for your active account (not your individual user), subject to your role's permissions. Use switch account to see stats for a different account. Admins fetching a specific user get that user's per-user view.
For per-billing-cycle usage (with limits and exceeded flags), use /account/usage. This endpoint focuses on raw cumulative numbers, not quota tracking.
Path parameters
Your user
uuid (the
uuid of
GET /v1/user). Any other user's uuid is a 404.
Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Response (200 OK)
The user of a per-user view. Omitted for the account aggregate.
Total endpoints currently owned.
Tunnels with at least one active agent.
Cumulative (lifetime) bytes in/out.
Cumulative (lifetime) request count.
Bytes in/out for the current billing period.
Request count for the current billing period.
Effective plan limits. -1 means unlimited (0 means none).
Effective per-period bandwidth/request limits. -1 means unlimited (0 means none).
When these figures were last refreshed.
Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
Errors
An integer id after the sunset (integer_id_unsupported).
The uuid isn't yours (or doesn't exist). Another user's uuid reads exactly like an unknown one.
curl "https://api.ngris.com/v1/stats/users/019a52c2-ca1e-78ba-ab5c-50362cc29134" \
-H "X-API-KEY: <your_api_key>"
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
stats = client._get_raw("/stats/users/019a52c2-ca1e-78ba-ab5c-50362cc29134")
print(f"{stats['endpoint_count']} endpoints, {stats['total_requests']:,} requests")
{
"plan": "pro",
"tunnel_count": 6,
"endpoint_count": 4,
"active_tunnels": 2,
"total_bytes_in": 61728394,
"total_bytes_out": 61728395,
"total_requests": 99876,
"period_bytes_in": 5242880,
"period_bytes_out": 5242881,
"period_requests": 8123,
"last_updated": "2026-04-29T13:00:00Z"
}