---
title: Username Forgot
slug: public-apis/username-forgot
createdAt: 2026-03-11T19:10:45.829Z
---

::::ExpandableHeading
###

**Topic type: Concept**

:::hint{type="warning"}
**Purpose:&#x20;**&#x55;sername Forgot event overview and guidance on when to send the event.&#x20;

**Audience:** Developers implementing account recovery flows for username retrieval.&#x20;

**Applies to:&#x20;**&#x41;ccount Protection integrations evaluating username recovery attempts.&#x20;

**Does not apply to:&#x20;**&#x41;ccount creation, authentication, or password reset completion events.
:::
::::

The `usernameForgot` call is intended to retrieve an Account Protection Score when a user asks you to help them remember their username on your website.

### Timing

The API call should come to the Interceptas Platform:

- After a user attempts to retrieve their username.
- After they pass error handling, and you retrieve their IP Address, and User Agent.
- Before you send the result of their request.

### Flow

![Username Forgot flow diagram](https://api.archbee.com/api/optimize/C_ua77kdJRrVi_Gd-0NCF/JG7Sdt1KZiQiFrs3KPna6-20260318-154723.jpg "Username Forgot flow")

1. User navigates to your Username Forgot flow.
2. User enters username retrieval option, such as email address, or phone.
3. Client processes frontend validation to ensure all fields are filled in properly.
4. Client checks backend error handling (account doesn't exist).
5. Client retrieves account information, IP, and user agent.
6. Client's backend server calls Accertify to determine whether they passed backend error handling or not.
7. Accertify consolidates data and returns a score.
8. Client determines the appropriate action for `usernameForgot`.



***

**See also**:

::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/C_ua77kdJRrVi_Gd-0NCF/4VRPIgGNjk81XwCl3Q2ea-20260326-200545.png"}
[Username Forgot Fields](docId\:IEgdNIWhw6RKIlNovW6F-)
:::
::::

