---
title: "Get a list of Sign-in logs"
method: GET
path: "/api/v1/logs/sign-in"
tags: ["Logs"]
---

# Get a list of Sign-in logs

`GET /api/v1/logs/sign-in`

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/oauth2/v1/token`

Required scope - root

## Query parameters

- `page_size` integer
- `page_number` integer

## Response `200`

A list of Sign-in logs

- object
  - `logs` SignInLog[]
    - `id` number, required
    - `userId` number, required
    - `ip` string, nullable, required
    - `detail` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, required
  - `count` integer: Total number of logs matching the query

## Changes

- **2024-10-03** `795cad873b47`: 7 info
  - the response property `logs/items/createdAt` became required for the status `200`
  - the response property `logs/items/deletedAt` became required for the status `200`
  - the response property `logs/items/detail` became required for the status `200`
  - the response property `logs/items/id` became required for the status `200`
  - …3 more
- **2024-10-01** `ffd604cd7944`: 1 info
  - endpoint added
- **2024-08-11** `11e2773b3a1e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/valuemelody/apis/melody-auth-s2s-api/changes/api/v1/logs/sign-in/get.md)

---

[API](https://skmtc.dev/valuemelody/apis/melody-auth-s2s-api.md) - [All operations](https://skmtc.dev/valuemelody/apis/melody-auth-s2s-api/llms.txt) - [OpenAPI document](https://skmtc.dev/valuemelody/apis/melody-auth-s2s-api/revisions/52fa61c3fee7?raw)