Verify Session
Verify session in an application by session token and/or optionally extend the expiration time of the session by N minutes from now if the session_expires_in
property is present.
HTTP Request
POST /v1/auth/sessions/verify
Returns
A successful response returns a Session
object with associated authentication factors that include unique identifiers and delivery methods.
Body
-
session_token string
Required if session_jwt not present
Unique Session Token to verify.Minimum length is
1
. -
session_jwt string
Required if session_token not present
Unique Session JWT to verify.
POST /v1/auth/sessions/verify
curl \
-X POST https://api.streambird.io/v1/auth/sessions/verify \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"session_token":"NGTCMAk51ItYAan83C6BLYXm7iJsKY0kCpsVj5WdJGg10eslpceC6MSS2RSqbUzT","session_expires_in":1000}'
Request example
{
"session_token": "NGTCMAk51ItYAan83C6BLYXm7iJsKY0kCpsVj5WdJGg10eslpceC6MSS2RSqbUzT",
"session_expires_in": 1000
}
Response examples (200)
{
"session": {
"id": "sess_24tZ6tlJ7CxlTwB6Zoj6SHQ9vU3",
"user_id": "user_24wFP9pDa9YiMJLun94iKykoZs2",
"started_at": 1643163802,
"expires_at": 1643288111,
"last_active_at": 1643228111,
"factors": [
{
"delivery_channel": "sms",
"type": "otp",
"method": {
"method_id": "pn_24oXBLRv6BoHXbNZoTAZkAFlRsy",
"method_type": "phone_number",
"phone_number_id": "pn_24oXBLRv6BoHXbNZoTAZkAFlRsy",
"phone_number": "+14152222222",
"last_verified_at": 1643163802
}
}
],
"device_fingerprint": {
"user_agent": "",
"ip": ""
},
"updated_at": 1643228111,
"created_at": 1643163802
},
"session_token": "NGTCMAk51ItYAan83C6BLYXm7iJsKY0kCpsVj5WdJGg10eslpceC6MSS2RSqbUzT",
"session_jwt": "eyJhbGciOiJIU..."
}