Authenticate a session token or session JWT and retrieve associated session data. If `session_duration_minutes` is included, update the lifetime of the session to be that many minutes from now. All timestamps are formatted according to the RFC 3339 standard and are expressed in UTC, e.g. `2021-12-29
Stytch Consumer Sessions Authenticate Example is an example object payload from Stytch, with 5 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
{
"title": "Authenticate",
"endpoint": "POST /v1/sessions/authenticate",
"description": "Authenticate a session token or session JWT and retrieve associated session data. If `session_duration_minutes` is included, update the lifetime of the session to be that many minutes from now. All timestamps are formatted according to the RFC 3339 standard and are expressed in UTC, e.g. `2021-12-29",
"request": {
"method": "POST",
"path": "/v1/sessions/authenticate",
"headers": {
"Authorization": "Basic <base64(project_id:secret)>",
"Content-Type": "application/json"
},
"body": {
"session_token": "<session_token>",
"session_duration_minutes": 3600,
"session_jwt": "<session_jwt>",
"session_custom_claims": {}
}
},
"response": {
"status": 200,
"body": {
"request_id": "example-value",
"session_token": "example-value",
"session_jwt": "example-value",
"status_code": 200
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.