> For the complete documentation index, see [llms.txt](https://docs.starfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.starfall.ai/api-reference/auth-token.md).

# Auth token

Login using username and password to obtain a token.

## Get auth token for a user using username and password

<mark style="color:green;">`POST`</mark> `https://api.starfall.ai/auth-token`

#### Request Body

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

{% tabs %}
{% tab title="200: OK Success" %}

```json
{
  "token": "string"
}
```

{% endtab %}
{% endtabs %}