---
title: "Log-in into system"
method: POST
path: "/session/login"
tags: ["Session management"]
---

# Log-in into system

`POST /session/login`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/session/login`
- Auth: none declared. Required headers: `X-App-Build`, `X-App-Version`, `X-App-Language`, `X-App-Platform`
- TypeScript: <https://skmtc.dev/sapienzaapps/apis/fantastic-coffee-decaffeinated/docs/session/login/post.ts> (a function with typed inputs; its response is checked against the schema)

Perform a log-in action using username and password credentials.
Returns a token which can be used in authenticated requests.

## Request body `application/x-www-form-urlencoded`

- object
  - `userid` string
  - `password` string

## Response `200`

Login successful

## Other responses

- `400`: The request was not compliant with the documentation (eg. missing fields, etc)
- `403`: Login failed
- `500`: The server encountered an internal error. Further info in server logs

---

[API](https://skmtc.dev/sapienzaapps/apis/fantastic-coffee-decaffeinated.md) - [All operations](https://skmtc.dev/sapienzaapps/apis/fantastic-coffee-decaffeinated/llms.txt) - [OpenAPI document](https://skmtc.dev/sapienzaapps/apis/fantastic-coffee-decaffeinated/revisions/d003dbf3b487?raw)