Skip to main content
GET
/
api
/
v1
/
orgs
/
{org}
/
principals
/
{principal}
/
sessions
List login sessions
curl --request GET \
  --url https://auth.cognite.com/api/v1/orgs/{org}/principals/{principal}/sessions
{
  "items": [
    {
      "id": "aea91e72-a984-4a4c-ba06-a7f54e650825",
      "createdTime": 123,
      "status": "ACTIVE",
      "deactivatedTime": 123
    }
  ],
  "nextCursor": {
    "cursor": "4zj0Vy2fo0NtNMb229mI9r1V3YG5NBL752kQz1cKtwo"
  }
}

Path Parameters

org
string
required

ID of an organization The ID of an organization

Required string length: 3 - 64
Pattern: ^([a-z][a-z0-9-]{1,62}[a-z0-9])$
Example:

"my-org"

principal
string
required

ID of a principal Unique identifier of a principal

Example:

"5yAFQRAATb7vtWGp4gvbJD3wE7VS81CGuQ7EZT"

Query Parameters

cursor
string

Cursor for paging through results. In general, if a response contains a nextCursor property, it means that there may be more results, and you should pass that value as the cursor parameter in the next request.

Note that the cursor may or may not be encrypted, but either way, it is not intended to be decoded. Its internal structure is not a part of the public API, and may change without notice. You should treat it as an opaque string and not attempt to craft your own cursors.

Example:

"4zj0Vy2fo0NtNMb229mI9r1V3YG5NBL752kQz1cKtwo"

limit
integer

The maximum number of items to return.

Required range: 1 <= x <= 1000

Response

A list of login sessions, with a cursor pointing to the next results page (if any).

items
object[]
required
nextCursor
object

Cursor for paging through results. In general, if a response contains a nextCursor property, it means that there may be more results, and you should pass that value as the cursor parameter in the next request.

Note that the cursor may or may not be encrypted, but either way, it is not intended to be decoded. Its internal structure is not a part of the public API, and may change without notice. You should treat it as an opaque string and not attempt to craft your own cursors.

Last modified on April 23, 2026