---
title: "Sign-in and sign-up attempts with their outcome"
method: GET
path: "/api/v1/admin/auth-events"
tags: ["Admin"]
---

# Sign-in and sign-up attempts with their outcome

`GET /api/v1/admin/auth-events`

## Request

- Base URL: `https://otprun.com`
- URL: `https://otprun.com/api/v1/admin/auth-events`
- Auth: HTTP bearer

## Query parameters

- `result` 'success' | 'failure'
- `method` 'email' | 'whatsapp' | 'telegram'
- `contact` string: Full phone number or email to look up, matched by its hash
- `cursor` string
- `limit` integer

## Response `200`

OK

- EventsOutputBody2
  - `items` AdminAuthEventBody[], nullable, required
    - `contact` string, required: Masked phone number or email
    - `created_at` string, date-time, required
    - `id` string, required
    - `ip` string, required
    - `kind` 'code_request' | 'login' | 'register' | 'account_deleted', required
    - `method` 'email' | 'whatsapp' | 'telegram', required
    - `reason` string, required: Why it failed: wrong_code, expired, locked, no_account, wrong_password, rate_limited, unavailable, invalid, email_taken or mismatch. On success it is empty, or unverified_reset when the sign-in reset an account whose email was never confirmed
    - `result` 'success' | 'failure', required
    - `user_agent` string, required
    - `user_id` integer, nullable, required
  - `next_cursor` string

## Other responses

- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/otprun/apis/otp-run-api.md) · [All operations](https://skmtc.dev/otprun/apis/otp-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/otprun/apis/otp-run-api/revisions/43d40d5f4050?raw)