Skip to main content
GET
/
v2
/
auth
/
process
Retrieve authentication process
curl --request GET \
  --url https://{projectId}.frontendapi.corbado.io/v2/auth/process \
  --header 'Authorization: Bearer <token>'
{
  "blockBody": {
    "block": "signup-init",
    "authType": "signup",
    "data": {
      "blockType": "<string>",
      "challenge": "<string>",
      "identifierValue": "<string>",
      "identifierType": "email",
      "autoSubmit": true,
      "passkeyIconSet": "default",
      "variant": "default"
    },
    "alternatives": [
      {}
    ],
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "continueOnOtherDevice": {
      "reason": "email-link-verified"
    }
  },
  "common": {
    "appName": "<string>",
    "frontendApiUrl": "<string>",
    "hideBadge": true,
    "environment": "<string>"
  },
  "newProcess": {
    "token": "<string>",
    "expiresAt": 123
  }
}

Authorizations

​
Authorization
string
header
required

After a user logs in successfully, a session is created and a JWT token is returned. This token represents the user's authenticated session. It must be included in the Authorization header as a Bearer token for all protected endpoints:

Authorization: Bearer <your-token>

The server will validate this token to authorize access.

Query Parameters

​
preferredBlock
enum<string>
Available options:
signup-init,
passkey-append,
phone-verify,
email-verify,
passkey-appended,
completed,
social-verify,
login-init,
passkey-verify,
conditional-ui-completed,
post-signup-email-verify,
passkey-append-after-hybrid

Response

200 - application/json

tbd

​
blockBody
object
required
​
common
object
required
​
newProcess
object