# @vonage/verify2

> Verify API provides a choice of routes for sending a code to a user. You can use this to confirm a user's contact information, as a second factor when authenticating users, or for step-up authentication.

Latest version **1.23.0** (published 2026-11-10) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @vonage/verify2
pnpm add @vonage/verify2
yarn add @vonage/verify2
bun add @vonage/verify2
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.23.0 |
| Published | 2026-11-10 |
| First published | 2023-04-12 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 400 |
| Maintainers | web-il, iceberg-team, unified_portal, vreporter-npm, vbcbe, yuri.guller, idanvon, nexmo-devrel, vvd, vonagemeetings, vonage-jenkins, adasilvacabral, sarvesh.bisht, vgai-dev, vonage_client_media_processing, or.cpc, llihovodov, daniel-sapir, aviadhouri.va, idelacruz, vonage-frontier, hilakl, saurabh.vonage, leppelin, asilvonage, gpojula, elimenko.vonage, kanav_vonage, omrizilber, molszewski_v, sailusha, rpalanisamy-vonage, vbohdan_vonage, abolles, gorka.vonage, bharath-vonage, morvonage, ilan.aradbilavsky.at.vonage.com, vonreeves, avi.dantes, mgalin, jhajduk.vonage, nitsanungerfrontier, vquezada, adidomenico, sathishr-vonage, pravallika-pamu, abagdi, anuradhlankapalli, hrosenberg, gokul-vonage, aslowe-vcc, vbc-web-cicd-bot, mserranomontes, ariel12955, franbecerra, urihaim, mvera_vonage, mike.zhylevych, mprabhuvonage, sharad-srivastava2, lucas_pilarski, manish-ranjan07, srajput0909, pvillenamontes, dsimoes2, manel_vonage, joliveraortega |

## Links

- npm: https://www.npmjs.com/package/@vonage/verify2
- Repository: https://github.com/Vonage/vonage-node-sdk
- Homepage: https://github.com/vonage/vonage-node-sdk/tree/main/packages/verify2#readme
- Issues: https://github.com/Vonage/vonage-node-sdk/issues
- npm.io page: https://npm.io/package/@vonage/verify2

## Recent versions

- 1.23.0 (latest) — 2026-11-10
- 1.22.10-0 (rc) — 2026-11-09
- 1.18.4-0 (pre) — 2026-04-22
- 1.22.9-0 — 2026-11-09
- 1.22.8-0 — 2026-11-09
- 1.22.7-0 — 2026-11-09
- 1.22.6-0 — 2026-11-09
- 1.22.1 — 2026-09-09
- 1.22.0 — 2026-09-01
- 1.21.0 — 2026-07-29
- 1.19.0 — 2026-03-25
- 1.18.3 — 2026-02-24
- 1.18.2 — 2026-02-23
- 1.18.1 — 2026-02-18
- 1.18.0 — 2026-01-28
- … 37 more at https://npm.io/package/@vonage/verify2/versions

## README

# Vonage Verify V2 SDK for Node.js

![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/vonage/vonage-node-sdk/ci.yml?branch=3.x) [![Codecov](https://img.shields.io/codecov/c/github/vonage/vonage-node-sdk?label=Codecov&logo=codecov&style=flat-square)](https://codecov.io/gh/Vonage/vonage-server-sdk) ![Latest Release](https://img.shields.io/npm/v/@vonage/verify2?label=%40vonage%2Fverify2&style=flat-square) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg?style=flat-square)](../../CODE_OF_CONDUCT.md) [![License](https://img.shields.io/npm/l/@vonage/accounts?label=License&style=flat-square)][license]


<img src="https://developer.nexmo.com/images/logos/vbc-logo.svg" height="48px" alt="Vonage" />

This is the Vonage Verify (for version 2) SDK for Node.js for use with [Vonage APIs](https://www.vonage.com/). To use it you will need a Vonage account. Sign up [for free at vonage.com][signup].

For full API documentation refer to [developer.vonage.com](https://developer.vonage.com/).

-   [Installation](#installation)
-   [Usage](#usage)
-   [Promises](#promises)
-   [Testing](#testing)

## Installation

We recommend using this SDK as part of the overall [`@vonage/server-sdk` package](https://github.com/vonage/vonage-node-sdk). Please see the main package for installation.

You can also use this SDK standalone if you only need access to just the Verify API.

### With NPM

```bash
npm install @vonage/verify2
```

### With Yarn

```bash
yarn add @vonage/verify2
```

## Usage

If you are using this SDK as part of the Vonage Server SDK, you can access it as the `verify2` property off of the client that you instantiate.

```js
const { Vonage } = require('@vonage/server-sdk')

const credentials = {
  apiKey: API_KEY,
  apiSecret: API_SECRET,
}
const options = {}
const vonage = new Vonage(credentials, options)

vonage.verify2
  .newRequest()
  .then((resp) => console.log(resp))
  .catch((err) => console.error(err))
```

### Standalone

The SDK can be used standalone from the main [Vonage Server SDK for Node.js](https://github.com/vonage/vonage-node-sdk) if you only need to use the Verify V2 API. All you need to do is `require('@vonage/verify2')`, and use the returned object to create your own client.

```js
const { Auth } = require('@vonage/auth')
const { Verify2 } = require('@vonage/verify2')

const credentials = new Auth({
  applicationId: APP_ID,
  privateKey: PRIVATE_KEY,
})
const options = {}
const verifyClient = new Verify2(credentials, options)
```

Where `credentials` is any option from [`@vonage/auth`](https://github.com/Vonage/vonage-node-sdk/blob/3.x/packages/auth/README.md#options), and `options` is any option from [`@vonage/server-client`](https://github.com/Vonage/vonage-node-sdk/blob/3.x/packages/server-client/README.md#options)

## Promises

Most methods that interact with the Vonage API uses Promises. You can either resolve these yourself, or use `await` to wait for a response.

```js
const resp = await verifyClient.checkCode(VERIFY_REQUEST_ID, CODE)

vonage.verify2
  .checkCode(VERIFY_REQUEST_ID, CODE)
  .then((resp) => console.log(resp))
  .catch((err) => console.error(err))
```

## Testing

Run:

```bash
npm run test
```

[signup]: https://dashboard.nexmo.com/sign-up?utm_source=DEV_REL&utm_medium=github&utm_campaign=node-server-sdk
[license]: ../../LICENSE.txt

---
_Source: https://npm.io/package/@vonage/verify2 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
