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

# Login route

`POST /login`

## Request body

- Login
  - `username` string, required
  - `password` string, required

## Response `200`

Login successful

- AccessToken
  - `token` string — Auth token
  - `id` string — Token id

## Other responses

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

## Changes

- **2019-09-02** `9310e1f32715` — 1 info
  - added the optional property `id` to the response with the `200` status
- **2019-05-07** `8a89a8f58853` — 2 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
- **2018-12-03** `a85cff4a1faa` — 2 breaking
  - the request's body type/format changed from `object`/`` to ``/``
  - the response's body type/format changed from `object`/`` to ``/`` 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-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/iam-api-for-oih/revisions/016871a170fd/schema)