👩‍💻
Transfers API Documentation
  • Transfers Checkout
  • Transfers Connect
    • Overview
    • Integration (SDK)
  • Connect API
    • GraphQL: Endpoints and Schema
    • Authentication
    • Customer Verification
    • Initiate Transfer Request
    • Get Transaction
    • Get Transactions
    • Fetch BVN
    • Fetch All Connections
    • Bank Statement
  • Webhooks
    • Webhook Confirmation
Powered by GitBook
On this page
  • Request Parameters
  • Response

Was this helpful?

  1. Connect API

Fetch BVN

You can retrieve the BVN for an account number with the fetchBVN query.

query {
  fetchBVN(accountNumber: "1234567890", bankCode: "058") {
    BankCode
    AccountName
    AccountNumber
    Bvn
  }
}

Response:

{
  "data": {
    "fetchBVN": [
      {
			    "BankCode": "058"
			    "AccountName": "FirstName MiddleName LastName"
			    "AccountNumber": "1234567890",
			    "Bvn": "123456789012345"
      }
    ]
  }
}

Request Parameters

Field

Scalar

Required

Description

accountNumber

String

Yes

The account number with which we require BVN information.

bankCode

String

Yes

The bank code of the accountNumber

Response

AccountName

Scalar

Mandatory Field

Description

Accountnumber

String

Yes

The account number for which BVN details are requested

BankCode

String

Yes

The bank code of the accountNumber

Account name

String

Yes

The name on the account number for which bvn details are requested

Bvn

String

Yes

The BVN number

PreviousGet TransactionsNextFetch All Connections

Last updated 3 years ago

Was this helpful?