---
title: "Check verification status by email"
method: GET
path: "/email-verification/status"
tags: ["email-verification"]
---

# Check verification status by email

`GET /email-verification/status`

Same response as GET /email-verification/status/:userId, for callers that only know the email. Includes the dismiss counter and `mustVerify`. An email with no user row yet returns 200 with `tracked: false` and zero dismissals; nothing is created by this call.

## Query parameters

- `email` string, required

## Response `200`

- VerificationStatusResponseDto
  - `success` boolean, required
  - `userId` number, nullable, required — null when the email has no user row yet (tracked=false)
  - `email` string, required
  - `verified` boolean, required
  - `verifiedAt` string, date-time, nullable
  - `dismissCount` number, required — Times the user closed the verify-email prompt without verifying
  - `maxDismissals` number, required — Dismissals allowed before the prompt becomes non-dismissable
  - `remainingDismissals` number, required — Dismissals the user still has left (0 once verified)
  - `mustVerify` boolean, required — True when the email is unverified and the limit is reached: the app must keep the prompt open
  - `lastDismissedAt` string, date-time, nullable
  - `tracked` boolean, required — false when the email has no user row yet; counting starts on the first POST /dismiss
  - `message` string

## Other responses

- `404` — User not found

## Changes

- **2026-09-18** `1f6f3b4ce14b` — 1 breaking, 1 info
  - the response property `userId` became nullable for the status `200`
  - added the required property `tracked` to the response with the `200` status
- **2026-09-17** `f7cc9325b5b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tonewow/apis/tonewow-database-api/changes/email-verification/status/get.md)

---

[API](https://skmtc.dev/tonewow/apis/tonewow-database-api.md) · [All operations](https://skmtc.dev/tonewow/apis/tonewow-database-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tonewow/apis/tonewow-database-api/revisions/60d5bbdc852a?raw)