Get a session
GET/v2/sessions/:sessionId
Get a session and all its information like the time of the user or password verification
Request​
Path Parameters
Query Parameters
Responses​
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
session
object
"id of the session"
"time when the session was created"
"time when the session was last updated"
"sequence of the session"
factors
object
"checked factors of the session, e.g. the user, password and more"
user
object
"time when the user was last checked"
"id of the checked user"
"login name of the checked user"
"display name of the checked user"
"organization id of the checked user"
password
object
"time when the password was last checked"
webAuthN
object
"time when the passkey challenge was last checked"
intent
object
"time when an intent was last checked"
totp
object
"time when the Time-based One-Time Password was last checked"
otpSms
object
"time when the One-Time Password was last checked"
otpEmail
object
"time when the One-Time Password was last checked"
metadata
object
"custom key value list"
userAgent
object
header
object
property name*
object
A header may have multiple values. In Go, headers are defined as map[string][]string, but protobuf doesn't allow this scheme.
"time the session will be automatically invalidated"
{
"session": {
"id": "string",
"creationDate": "2024-11-21T14:48:11.569Z",
"changeDate": "2024-11-21T14:48:11.569Z",
"sequence": "string",
"factors": {
"user": {
"verifiedAt": "2024-11-21T14:48:11.569Z",
"id": "string",
"loginName": "string",
"displayName": "string",
"organizationId": "string"
},
"password": {
"verifiedAt": "2024-11-21T14:48:11.569Z"
},
"webAuthN": {
"verifiedAt": "2024-11-21T14:48:11.569Z",
"userVerified": true
},
"intent": {
"verifiedAt": "2024-11-21T14:48:11.569Z"
},
"totp": {
"verifiedAt": "2024-11-21T14:48:11.569Z"
},
"otpSms": {
"verifiedAt": "2024-11-21T14:48:11.569Z"
},
"otpEmail": {
"verifiedAt": "2024-11-21T14:48:11.569Z"
}
},
"metadata": {},
"userAgent": {
"fingerprintId": "string",
"ip": "string",
"description": "string",
"header": {}
},
"expirationDate": "2024-11-21T14:48:11.569Z"
}
}
- Schema
- Example (from schema)
Schema
session
object
"id of the session"
"time when the session was created"
"time when the session was last updated"
"sequence of the session"
factors
object
"checked factors of the session, e.g. the user, password and more"
user
object
"time when the user was last checked"
"id of the checked user"
"login name of the checked user"
"display name of the checked user"
"organization id of the checked user"
password
object
"time when the password was last checked"
webAuthN
object
"time when the passkey challenge was last checked"
intent
object
"time when an intent was last checked"
totp
object
"time when the Time-based One-Time Password was last checked"
otpSms
object
"time when the One-Time Password was last checked"
otpEmail
object
"time when the One-Time Password was last checked"
metadata
object
"custom key value list"
userAgent
object
header
object
property name*
object
A header may have multiple values. In Go, headers are defined as map[string][]string, but protobuf doesn't allow this scheme.
"time the session will be automatically invalidated"
{
"session": {
"id": "string",
"creationDate": "2024-11-21T14:48:11.571Z",
"changeDate": "2024-11-21T14:48:11.571Z",
"sequence": "string",
"factors": {
"user": {
"verifiedAt": "2024-11-21T14:48:11.571Z",
"id": "string",
"loginName": "string",
"displayName": "string",
"organizationId": "string"
},
"password": {
"verifiedAt": "2024-11-21T14:48:11.571Z"
},
"webAuthN": {
"verifiedAt": "2024-11-21T14:48:11.571Z",
"userVerified": true
},
"intent": {
"verifiedAt": "2024-11-21T14:48:11.571Z"
},
"totp": {
"verifiedAt": "2024-11-21T14:48:11.571Z"
},
"otpSms": {
"verifiedAt": "2024-11-21T14:48:11.571Z"
},
"otpEmail": {
"verifiedAt": "2024-11-21T14:48:11.571Z"
}
},
"metadata": {},
"userAgent": {
"fingerprintId": "string",
"ip": "string",
"description": "string",
"header": {}
},
"expirationDate": "2024-11-21T14:48:11.571Z"
}
}
- Schema
- Example (from schema)
Schema
session
object
"id of the session"
"time when the session was created"
"time when the session was last updated"
"sequence of the session"
factors
object
"checked factors of the session, e.g. the user, password and more"
user
object
"time when the user was last checked"
"id of the checked user"
"login name of the checked user"
"display name of the checked user"
"organization id of the checked user"
password
object
"time when the password was last checked"
webAuthN
object
"time when the passkey challenge was last checked"
intent
object
"time when an intent was last checked"
totp
object
"time when the Time-based One-Time Password was last checked"
otpSms
object
"time when the One-Time Password was last checked"
otpEmail
object
"time when the One-Time Password was last checked"
metadata
object
"custom key value list"
userAgent
object
header
object
property name*
object
A header may have multiple values. In Go, headers are defined as map[string][]string, but protobuf doesn't allow this scheme.
"time the session will be automatically invalidated"
{
"session": {
"id": "string",
"creationDate": "2024-11-21T14:48:11.572Z",
"changeDate": "2024-11-21T14:48:11.572Z",
"sequence": "string",
"factors": {
"user": {
"verifiedAt": "2024-11-21T14:48:11.572Z",
"id": "string",
"loginName": "string",
"displayName": "string",
"organizationId": "string"
},
"password": {
"verifiedAt": "2024-11-21T14:48:11.573Z"
},
"webAuthN": {
"verifiedAt": "2024-11-21T14:48:11.573Z",
"userVerified": true
},
"intent": {
"verifiedAt": "2024-11-21T14:48:11.573Z"
},
"totp": {
"verifiedAt": "2024-11-21T14:48:11.573Z"
},
"otpSms": {
"verifiedAt": "2024-11-21T14:48:11.573Z"
},
"otpEmail": {
"verifiedAt": "2024-11-21T14:48:11.573Z"
}
},
"metadata": {},
"userAgent": {
"fingerprintId": "string",
"ip": "string",
"description": "string",
"header": {}
},
"expirationDate": "2024-11-21T14:48:11.573Z"
}
}
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}