---
title: "Login route"
method: POST
path: "/login"
tags: ["authentication"]
---

# Login route

`POST /login`

## Request body

- object
  - `username` string, required
  - `password` string, required

## Response `200`

Login successful

- object
  - `token` string — Auth token

## Other responses

- `400` — Bad request; Missing mandatory body
- `403` — Cannot login user. Account is either disabled or a precondition is missing.

## Changes

- **2018-12-03** `a85cff4a1faa` — 2 breaking
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`

[Change history](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/changes/login/post.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/llms.txt) · [OpenAPI document](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/revisions/018e854620e7?raw)