---
title: "BVN iGree"
method: POST
path: "/v1/ng/identities/bvn-with-consent/{bvn}"
---

# BVN iGree

`POST /v1/ng/identities/bvn-with-consent/{bvn}`

## Request

- Base URL: `https://api.qoreid.com`
- URL: `https://api.qoreid.com/v1/ng/identities/bvn-with-consent/{bvn}`
- Auth: OAuth 2

Verify a customer's Bank Verification Number (BVN) after obtaining the customer's consent through the NIBSS BVN consent flow. This service is intended for use cases where BVN verification requires the customer to provide consent before their BVN information can be retrieved.

## Path parameters

- `bvn` string, required

## Response `200`

200

- object
  - `bvn` string
  - `consentUrl` string
  - `consentStatus` boolean

## Other responses

- `400`: 400
- `412`: Precondition Failed

## Changes

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

[Operation history](https://skmtc.dev/qoreid/apis/baseurl/changes/v1/ng/identities/bvn-with-consent/:bvn/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)