---
title: "List Code Generators"
method: GET
path: "/v1/2fa"
tags: ["Two Factor Authentication"]
---

# List Code Generators

`GET /v1/2fa`

This endpoint helps you return a list of all code generators previously configured.

## Query parameters

- `limit` integer
- `skip` integer
- `offset` string
- `sort` string
- `select` string

## Response `200`

Succeed, 2FA Information Retrieved

- TwoFactorListResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure
  - `pagination` PageDTO — pagination information
    - `offset` string — start point
    - `limit` integer — items to be displayed by page
    - `next` string — next item to be consulted in the following invocation
    - `page` integer — current page of data
    - `pages` integer — total amount of pages in the response
    - `total` integer — total amount of items in the response
  - `items` TwoFactorDTO[] — two factor configuration list
    - `id` integer, required — two factor configuration id
    - `codeLength` integer, required — character length to generate codes
    - `expirationMinutes` integer, required — minutes to expire a code
    - `channels` ChannelDTO[], required — two factor authentication pair channel-from
      - `subject` string — subject for email channel
      - `shortcode` string — shortcode for SMS channel
      - `from` string — from for email channel
      - `text` string — two factor authentication message
      - `placeholder` string — whatsapp template placeholder
      - `address` string — Sender mobilenumber for Whatsapp channel
      - `templateName` string — Whatsapp message template name
      - `templateId` string — Whatsapp message template id
      - `templateLanguage` string — Whatsapp message template language
      - `type` 'SMS' | 'EMAIL' | 'WHATSAPP' | 'SMS' | 'EMAIL' | 'WHATSAPP' — two factor authentication channel

## Other responses

- `401` — User not allowed
- `403` — Forbidden Access
- `404` — no two factor configuration were found
- `500` — Internal Server Error

---

[API](https://skmtc.net/messangi/apis/raven.md) · [All operations](https://skmtc.net/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messangi/raven/versions/c87f398fa338/schema)