---
title: "List 2FA verification events"
method: GET
path: "/v1/two-fa/session/{session_id}/events"
tags: ["2FA"]
---

# List 2FA verification events

`GET /v1/two-fa/session/{session_id}/events`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/two-fa/session/{session_id}/events`
- Auth: HTTP bearer

Returns the lifecycle events of the 2FA verification identified by `session_id`, such as number lookup and code delivery.

## Path parameters

- `session_id` string, required

## Response `200`

Returns the list of 2FA verification events.

- TwoFactorVerificationEvent[]
  - `created_at` string, date-time, required: Date and time of the event
  - `event` string, required: Human-readable event description. One of the following values: - `Number lookup` — the Wavix platform checked whether the destination phone number is valid. Returned only when number validation is enabled for the 2FA Service. - `Code sent via SMS` — a code was sent via SMS. - `Code sent via voice` — a code was sent via a voice call. - `Verification` — a code verification attempt.
  - `status` string, required: Status of an action associated with the event. Can be either `success`, `failed`, or `pending`.
  - `charge` string, required: Cost of an operation associated with the event, in USD
  - `error` string, nullable, required: Error description, if any

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Returns when no verification matches `session_id`.

## Changes

- **2026-09-08** `6a89c962481c`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/RecordNotFoundErrorResponse` from the response body `allOf` list for the response status `404`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - …2 more
- **2026-06-15** `76b9bb35619f`: 1 warning
  - removed the optional property `error_code` from the response with the `403` status
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/two-fa/session/:session_id/events/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)