> For the complete documentation index, see [llms.txt](https://developer.leaderos.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.leaderos.net/auth/login.md).

# Login

<mark style="color:green;">`POST`</mark> `https://yourwebsite.com/api/auth/login`

#### Request Body

| Name                                        | Type   | Description |
| ------------------------------------------- | ------ | ----------- |
| username<mark style="color:red;">\*</mark>  | string |             |
| password<mark style="color:red;">\*</mark>  | string |             |
| ip<mark style="color:red;">\*</mark>        | string |             |
| useragent<mark style="color:red;">\*</mark> | string |             |

{% tabs %}
{% tab title="200: Successful" %}

```json
{
    "status": true,
    "data": {
        "token": "202cb962ac59075b964b07152d234b70",
        "isTfaRequired": false
    }
}
```

{% endtab %}

{% tab title="404: User not found" %}

```json
{
    "status": false,
    "error": "USER_NOT_FOUND",
    "message": "User not found!"
}
```

{% endtab %}

{% tab title="401: Wrong password" %}

```json
{
    "status": false,
    "error": "WRONG_PASSWORD",
    "message": "Wrong password!"
}
```

{% endtab %}
{% endtabs %}