Authorize

Production

https://api.msaaq.com/v1

POST

/tenant/auth/authorize

Last modified:2025-05-12 23:57:12

This endpoint is used to authenticate or register a user based on their current status. If the user is already registered and exists in the system, they will be logged in. Otherwise, if the user is not registered, they will be prompted to complete the registration process. The response from this endpoint will provide the next action that the user should take, either entering their password if they have previously set one, or entering the OTP (One-Time Password) that has been sent to their phone or email, depending on the value of the via parameter.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

X-Tenant

string

required

Example:

string

required

Example:

application/json

Body Params multipart/form-data

via

string

required

Example:

string

required

Example:

example@msaaq.com

phone_code

string

required

phone

string

required

prefer_otp

string

required

Example:

true

login_only

string

required

Example:

true

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.msaaq.com/v1/tenant/auth/authorize' \
--header 'X-Tenant: academy.msaaq.com' \
--header 'Accept: application/json' \
--form 'via="email"' \
--form 'email="example@msaaq.com"' \
--form 'phone_code=""' \
--form 'phone=""' \
--form 'prefer_otp="true"' \
--form 'login_only="true"'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Authorize Verify