---
title: "Authenticate user"
method: POST
path: "/v2/login"
tags: ["auth"]
---

# Authenticate user

`POST /v2/login`

## Request body

- LoginRequest
  - `username` string, required
  - `password` string, required

## Response `200`

Successful authentication

- AuthData
  - `currentTs` integer, required — Current server timestamp (Unix seconds)
  - `expiryTs` integer, required — Return expiry timestamp (Unix seconds)
  - `entranceCount` integer, required
  - `notices` string[], required
  - `user` User, required
    - `tokenId` integer, required
    - `token` string, required
    - `rights` integer, required
  - `characters` Character[], required
    - `id` integer, required
    - `name` string, required
    - `isFemale` boolean, required
    - `weapon` integer, required
    - `hr` integer, required
    - `gr` integer, required
    - `lastLogin` integer, required — Unix timestamp of last login
    - `returning` boolean, required — True if character has not logged in for 90+ days
  - `courses` CourseInfo[], required
    - `id` integer, required
    - `name` string, required
  - `mezFes` MezFes, required
    - `id` integer, required
    - `start` integer, required
    - `end` integer, required
    - `soloTickets` integer, required
    - `groupTickets` integer, required
    - `stalls` integer[], required
  - `patchServer` string, required

## Other responses

- `400` — Invalid credentials or malformed request
- `500` — Internal server error

---

[API](https://skmtc.dev/mezeporta/apis/erupe-api.md) · [All operations](https://skmtc.dev/mezeporta/apis/erupe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mezeporta/erupe-api/revisions/08897afa315e/schema)