Monitor Identity Verification History
Use Identity Verification History to monitor and audit up to 20,000 records of your org users’ identity verification attempts from the past 6 months. For example, when a user successfully provides a time-based, one-time password (TOTP) as proof of identity during multi-factor authentication (MFA), that information is recorded in Identity Verification History.
Required Editions
| Available in: Essentials, Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions |
To access Identity Verification History, from Setup, enter Verification History in the Quick Find box, then select Identity Verification History. To view more information, such as the user’s approximate geographic location when verified, create a custom view, and add the columns you want.
Identity Verification Fields
The following fields are displayed by default.
| Field | Description |
|---|---|
| Time | The date and time of the identity verification attempt, for example, 7/19/2025, 3:19:13 PM PDT. The time zone is based on
GMT. |
| Verification Attempt | ID of the verification attempt. Verification can involve several attempts and use different verification methods. For example, in a user’s session, a user enters an invalid verification code (first attempt). The user then enters the correct code and successfully verifies identity (second attempt). Both attempts are part of a single verification and, therefore, have the same ID. |
| Username | The username of the user challenged for identity verification. |
| Activity Message | The text the user sees on the page or in Salesforce Authenticator when prompted to verify identity. For example, if identity verification is required for a user’s login, the user sees “You’re trying to Log In to Salesforce.” In this case, the activity message is “Log In to Salesforce.” If the user activity is “Apex-defined activity,” the activity message can be a custom description passed by an Apex method. If the user is verifying identity using Salesforce Authenticator 2.0 or later, the custom description appears in the app and in Identity Verification History. If the custom description isn’t specified, Identity Verification History shows the name of the Apex method. If the user attempted to access a connected app, but the app was renamed or deleted after the verification attempt, this field shows the original connected app name. |
| Triggered By | The identity verification security policy or setting.
|
| Method | The method by which the user attempted to verify identity in the verification event.
|
| Status | The status of the identity verification attempt.
|
| Login Time | Time of the login attempt, in GMT time zone. |
| Source IP | The IP address of the machine from which the user attempted the action that requires identity verification. For example, the IP address of the machine from where the user tried to log in or access reports. If it’s a non-login action that required verification, the IP address can be different from the address from where the user logged in. This address can be an IPv4 or IPv6 address. |
| Location | The country where the user’s IP address is physically located. This value is not localized. Due to the nature of geolocation technology, the accuracy of geolocation fields (for example, country, city, postal code) can vary. |
You can display the following fields by creating a custom view. In the description, the IP address is the address of the machine from which the user attempted the action that requires identity verification. Due to the nature of geolocation technology, the accuracy of geolocation fields (for example, country, city, postal code) can vary.
| Field | Description |
|---|---|
| City | The city where the user’s IP address is physically located. This value isn’t localized. |
| Connected App | The name and link to the connected app the user attempted to access. If the connected app was renamed since the user’s verification attempt, it shows the new name. If the connected app was deleted since the user’s verification attempt, it shows “Unavailable.” |
| Country | The country where the user’s IP address is physically located. This value isn’t localized. |
| CountryIso | The ISO 3166 code for the country where the user’s IP address is physically located. For more information, see Country Codes - ISO 3166. |
| Latitude | The latitude where the user’s IP address is physically located. |
| Login Type | The type of login used to access the session. |
| Longitude | The longitude where the user’s IP address is physically located. |
| Postal Code | The postal code where the user’s IP address is physically located. This value isn’t localized. |
| Subdivision | The name of the subdivision where the user’s IP address is physically located. In the United States, this value is usually the state name (for example, Pennsylvania). This value isn’t localized. |
| User Activity | The action the user attempted that requires identity verification.
|

