Count Signed-in Users
Count who is signed in to an endpoint right now: the users, their browsers and how those browsers signed in, and when everyone was last signed out. Read it before you sign everyone out, or before you switch a sign-in method off, to know who it signs out. The dashboard's Sign everyone out confirm shows these counts.
Access tokens and API keys aren't counted: they aren't browser sessions, and no sign-out touches them.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.Response (200 OK)
endpoint_uuid string (uuid)
The endpoint.
users integer
Users signed in on at least one browser.
browsers integer
Browsers signed in:
browsers_by_method.password + browsers_by_method.sso + older_sign_ins.browsers_by_method object
{"password": int, "sso": int}: the browsers that signed in since 10 November 2026, by how they signed in. Switching a method off signs out its browsers.older_sign_ins integer
Browsers that signed in before 10 November 2026, one per user, IP address and browser. Switching a method off doesn't sign them out: they run out at the end of their session, unless you sign their user out everywhere or sign everyone out.
signed_out_before datetime?
When everyone was last signed out of the endpoint. Omitted if never.
session_ttl_seconds integer
How long a browser stays signed in on this endpoint:
14400 (4 hours) unless you changed it with PUT /v1/endpoints/{uuid}/settings.Errors
401 Unauthorized
Missing auth.
403 Forbidden
Caller lacks the
endpoints:read permission in the active account.404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/sessions" \
-H "X-API-KEY: <your_api_key>"
CLI
ngris api endpoint-users signed-in 019bb1e4-e785-77d2-9966-c3cff31d0a0e
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
c = client._get_raw("/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/sessions")
print(f"{c['users']} users on {c['browsers']} browsers")
Response — 200 OK
{
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"users": 6,
"browsers": 9,
"browsers_by_method": {"password": 5, "sso": 2},
"older_sign_ins": 2,
"session_ttl_seconds": 14400
}
Was this helpful?