Verify BVN Consent

curl --request GET \
  --url https://api.flutterwave.com/v3/bvn/verifications/{reference} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.flutterwave.com/v3/bvn/verifications/{reference}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.flutterwave.com/v3/bvn/verifications/{reference}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bvn/verifications/{reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bvn/verifications/{reference}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bvn/verifications/{reference}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bvn details fetched",
  "data": {
    "first_name": "Nibby",
    "last_name": "Certifier",
    "status": "INITIATED",
    "reference": "FLWA968D23A3D2BE31F5D63D0",
    "callback_url": null,
    "bvn_data": null,
    "created_at": "2024-03-18T10:52:13.000Z"
  }
}

{
  "status": "error",
  "message": "Bvn details not found",
  "data": null
}

GET

bvn

verifications

{reference}

Verify BVN Consent

curl --request GET \
  --url https://api.flutterwave.com/v3/bvn/verifications/{reference} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.flutterwave.com/v3/bvn/verifications/{reference}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.flutterwave.com/v3/bvn/verifications/{reference}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bvn/verifications/{reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bvn/verifications/{reference}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bvn/verifications/{reference}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bvn details fetched",
  "data": {
    "first_name": "Nibby",
    "last_name": "Certifier",
    "status": "INITIATED",
    "reference": "FLWA968D23A3D2BE31F5D63D0",
    "callback_url": null,
    "bvn_data": null,
    "created_at": "2024-03-18T10:52:13.000Z"
  }
}

{
  "status": "error",
  "message": "Bvn details not found",
  "data": null
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

reference

string

required

Example:

"FLWA968D23A3D2BE31F5D63D0"

Response

status

string

required

message

string

required

data

Data90 · object

required

Show child attributes

Example:

{
  "first_name": "Nibby",
  "last_name": "Certifier",
  "status": "INITIATED",
  "reference": "FLWA968D23A3D2BE31F5D63D0",
  "callback_url": null,
  "bvn_data": null,
  "created_at": "2024-03-18T10:52:13.000Z"
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Verify BVN Consent

Authorizations

Path Parameters

Response