Skip to content
Whitelisting

List active whitelistings

Return MACs that currently have an active session in the Context.

GET /v1/org/{organizationId}/contexts/sign-in/{contextId}/modules/whitelistings/active

Returns the set of whitelisted MACs that are currently online — useful for reconciling an asset-management system against who’s actually connected.

ParameterInTypeRequiredDescription
organizationIdPathstringYesOrganization ID.
contextIdPathstringYesSign-In Context ID.
x-auth-tokenHeaderstringYesContext API key.

Request example

cURL
curl "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings/active" \
-H "x-auth-token: $NETGRAPH_API_TOKEN"

A JSON array of MAC addresses currently online in the Context.

Response example

200
[
"AA:BB:CC:00:00:01",
"AA:BB:CC:00:00:07"
]

Next