Login API
Welcome to the documentation for the Login API. This API helps user's to login to their account.
Base URL
{baseURL}/v1/users/login | POSTRequest Payload
| Field | Type | Source | Required | Description |
|---|---|---|---|---|
| questionId | string | body | ✅ Yes | Security question ID |
| answer | string | body | ✅ Yes | User's answer to security question |
| token | string | body | ✅ Yes | 2FA access token |
Sample Request
curl -X POST {baseURL}/v1/users/login \
-H 'Content-Type: application/json' \
-d '{
"questionId": "63f697bf78528f949a0c175b",
"answer": "111",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiNjRmNDk2Mjc4NGE1Njc2MDg3ZTIzNWNjIiwicXVlc3Rpb25faWQiOiI2M2Y2OTdiZjc4NTI4Zjk0OWEwYzE3NWIiLCJpYXQiOjE2OTM3NTM0NjQsImV4cCI6MTcyNTI4OTQ2NH0.nab7zLDthAnxKqT5n0EVAlIVTTvYhF0NpLrUmCjiT6s"
}'Sample 200 Response
{
"message": "Login successfully",
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiNjRmNDk2Mjc4NGE1Njc2MDg3ZTIzNWNjIiwiaWF0IjoxNjkzNzUzNDk3LCJleHAiOjE3MjUyODk0OTd9.3qzPFp60Q6fn2kzT3BVerHJHJKG8cT5DB9tzFqfzO2Q",
"user": {
"_id": "64f4962784a5676087e235cc",
"first_name": "Oluwatunmise",
"last_name": "Adenuga",
"email": "[email protected]",
"phone_number": "07031832236",
"role_id": "64e8b1de85671e19e26d717d",
"is_verified": true,
"account_id": "64da4abd605200f551d8e9b6",
"organization_id": "64da45f2605200f551d8e9ac",
"gender": "male",
"is_2FA_enabled": true,
"is_default_password": false,
"status": "active",
"security_questions": [
{
"question": "63f697bf78528f949a0c175b",
"answer": "$2a$10$SsjtJOXxStKfX7.QemmKku2dFoL1K8hmrUGVsdgl.KQ00L3m5LKki",
"_id": "64f4972e84a5676087e235ee"
},
{
"question": "63f697bf78528f949a0c175b",
"answer": "$2a$10$YlZi1YQxErLFNUGcFpESgug2Awhm05Qjcm2DbSBtCilCmVvakKmTK",
"_id": "64f4972e84a5676087e235ef"
},
{
"question": "6408750686aba885d609e701",
"answer": "$2a$10$7gJ990Z24PsxGnVmOPmBFOw6Jku8LFkWiCIMNy7cArAAR4sToBtuu",
"_id": "64f4972e84a5676087e235f0"
}
],
"createdAt": "2023-09-03T14:20:23.973Z",
"updatedAt": "2023-09-03T15:04:57.890Z",
"__v": 20
}
},
"success": true
}