---
title: "vNIN (Virtual NIN)"
method: POST
path: "/v1/ng/identities/virtual-nin/{vNIN}"
---

# vNIN (Virtual NIN)

`POST /v1/ng/identities/virtual-nin/{vNIN}`

## Request

- Base URL: `https://api.qoreid.com`
- URL: `https://api.qoreid.com/v1/ng/identities/virtual-nin/{vNIN}`
- Auth: OAuth 2

Verify a customer's identity using their uniquely generated virtual NIN. For more context on how the vNIN works, please see our [Guide](https://docs.qoreid.com/docs/vnin).

## Path parameters

- `vNIN` string, required

## Request body

- object
  - `firstname` string, required: First name
  - `lastname` string, required: Last name
  - `dob` string: Date of birth
  - `gender` string: Gender

## Response `200`

200

- object
  - `id` integer
  - `applicant` object
    - `firstname` string
    - `lastname` string
    - `phone` string
    - `gender` string
  - `summary` object
    - `v_nin_check` object
      - `status` string
      - `fieldMatches` object
        - `firstname` boolean
        - `lastname` boolean
        - `gender` boolean
        - `phoneNumber` boolean
  - `status` object
    - `state` string
    - `status` string
  - `v_nin` object
    - `firstname` string
    - `lastname` string
    - `middlename` string
    - `birthdate` string
    - `gender` string
    - `phone` string
    - `vNin` string
    - `photo` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `fd968e79b743`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qoreid/apis/baseurl/changes/v1/ng/identities/virtual-nin/:vNIN/post.md)

---

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