Login

POST

https://api.lootlocker.io/admin/v1/session

Initial Authentication Request

The initial login request is simple in that it just requires the users email and password sent in a POST request.

The response can vary depending if the user has Two-Factor Authentication enabled or not. See examples for more detail.

If the user has Two-Factor Authentication enabled, the mfa_key, sent back has en expiry time of 5 minutes. If the user does not manage to input the MFA token during this time, you should present them with the login form again.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Invalid Request Body

🟢200With MFA Enabled

🟠401Unauthorized (Need Verification)

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.lootlocker.io/admin/v1/session' \
--header 'LL-Version: 2021-03-01' \
--header 'Content-type: application/json' \
--data-raw '{
    "email": "",
    "password": ""
}'

Response Example

200 - Success

{
    "success": true,
    "auth_token": "ca8bbb2b2c88acb945383dcd43ca414756b3822e",
    "user": {
        "id": 10197,
        "name": "Some Dude",
        "email": "dev@lootlocker.com",
        "signed_up": 1705320108,
        "is_verified": true,
        "organisations": [
            {
                "id": 10485,
                "name": "Lootlocker",
                "games": [
                    {
                        "id": 23646,
                        "is_demo": false,
                        "name": "asd",
                        "badge_url": "",
                        "logo_url": "",
                        "development": {
                            "id": 23647,
                            "is_demo": false,
                            "name": "asd",
                            "badge_url": "",
                            "logo_url": ""
                        }
                    }
                ],
                "finalized_signup_at": "2024-01-15T12:02:28Z"
            }
        ]
    }
}

Modified at 2025-09-01 09:49:58

Verify Email

2FA

Login

Initial Authentication Request#

Request

Responses

Initial Authentication Request