Pre-login user identification

POST

/identify

const url = 'https://auth.timetonic.com/identify';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"userId":"user@example.com"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://auth.timetonic.com/identify \
  --header 'Content-Type: application/json' \
  --data '{ "userId": "user@example.com" }'

Check user authentication requirements before login. Returns SSO URL (if configured), 2FA status, and terms version. Used by frontend to determine login flow before showing password field.

Request Body^required

application/json

object

userId

required

User identifier (email, username, or external ID)

string

Example

user@example.com

Responses

200

User identification data

application/json

object

ssoUrl

One of:

string
boolean

string format: uri

ssoOnly

Whether SSO is the only allowed authentication method

boolean

twoFactor

Whether user has 2FA enabled

boolean

tcVersion

User’s accepted T&C version, null if not accepted

string

nullable

Example

{
  "ssoUrl": "/saml/tenant-key/login",
  "ssoOnly": false,
  "twoFactor": true,
  "tcVersion": "1.0"
}

422

Validation error

application/json

object

success

boolean

error

string

message

string

errors

object

key

additional properties

Array<string>

Example

{
  "success": false,
  "error": "validation_error",
  "message": "The given data was invalid",
  "errors": {
    "email": [
      "The email field is required."
    ]
  }
}

Pre-login user identification

Request Bodyrequired

Example

Responses

200

Example

422

Example

Request Body^required