ZITADEL Docs
APIsCore ResourcesV2Session

ListSessions

List sessions

Searches for sessions matching the given query. You can search by session ID, user ID, creation date, creator, user agent or expiration date.

Required permissions:

  • session.read
  • no permission required to search for own sessions
POST
/v2/sessions/search

Request Body

application/json

query?

List limitations and ordering.

queries?

The criteria to be used when searching for sessions. Multiple queries will be combined with a logical AND.

sortingColumn?string

The column to be used for sorting the sessions.

Value in"SESSION_FIELD_NAME_UNSPECIFIED" | "SESSION_FIELD_NAME_CREATION_DATE"
[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/v2/sessions/search" \  -H "Content-Type: application/json" \  -d '{}'
{
  "details": {
    "totalResult": 0,
    "processedSequence": 0,
    "timestamp": "1s"
  },
  "sessions": [
    {
      "id": "string",
      "creationDate": "1s",
      "changeDate": "1s",
      "sequence": 0,
      "factors": {
        "user": {
          "verifiedAt": "1s",
          "id": "string",
          "loginName": "string",
          "displayName": "string",
          "organizationId": "string"
        },
        "password": {
          "verifiedAt": "1s"
        },
        "webAuthN": {
          "verifiedAt": "1s",
          "userVerified": true
        },
        "intent": {
          "verifiedAt": "1s"
        },
        "totp": {
          "verifiedAt": "1s"
        },
        "otpSms": {
          "verifiedAt": "1s"
        },
        "otpEmail": {
          "verifiedAt": "1s"
        },
        "recoveryCode": {
          "verifiedAt": "1s"
        }
      },
      "metadata": {
        "property1": "string",
        "property2": "string"
      },
      "userAgent": {
        "fingerprintId": "string",
        "ip": "string",
        "description": "string",
        "header": {
          "property1": {
            "values": [
              "string"
            ]
          },
          "property2": {
            "values": [
              "string"
            ]
          }
        }
      },
      "expirationDate": "1s"
    }
  ]
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?