BVN Modification API

Submit and track Bank Verification Number (BVN) modification requests across all authorized banking partner pipelines. Any service ending with Bank or Banking is classified as a BVN Modification service.

Service Online / Available

POST /api/v1/bvn/modification

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes
`Content-Type`	`application/json`	Yes
`Accept`	`application/json`	Yes

Authorized Banking Field Codes & Realtime Pricing

All active and available modification options from banking pipelines with role-tailored pricing.

Role: Default

FIELD CODE	BANK / PIPELINE	MODIFICATION SERVICE	DESCRIPTION	PRICE (₦)	STATUS
`003`	FIRST BANK	Correction of name	correction of name of bvn enrolled...	₦12,000.00	Available
`004`	FIRST BANK	Date of birth update	Correction of date of birth on...	₦10,000.00	Available
`006`	FIRST BANK	Correction of name and date of birth	Correction of name and date of...	₦15,000.00	Available
`007`	FIRST BANK	Complete change of name	change complete name on bvn enrolled...	₦50,000.00	Available
`008`	FIRST BANK	Gender Update	Update BVN gender that enrolled at...	₦5,000.00	Available
`009`	FIRST BANK	Bvn Revalidation	Revalidate bvn that is showing empty...	₦10,000.00	Available
`010`	FIRST BANK	Whitelist BVN	Request for bvn whitelist if loan...	₦15,000.00	Available
`060`	FIRST BANK	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`050`	FIRST BANK	Correction of Name, DOB and phone NO	Correction of bvn enrolled at first...	₦18,000.00	Available
`E001`	ECO BANK	Correction of Name	Correction of ecobank bvn on name	₦10,000.00	Available
`E002`	ECO BANK	Date of birth update	Correction of date of birth on...	₦10,000.00	Available
`E003`	ECO BANK	Gender Update	Correction of gender on bvn enrolled...	₦10,000.00	Available
`E004`	ECO BANK	Phone number and email update	Correction of email or phone of...	₦10,000.00	Available
`E005`	ECO BANK	Correction of name and date of birth	Correction of name and date of...	₦15,000.00	Available
`E006`	ECO BANK	Complete Change of name	Complete change of name on BVN	₦120,000.00	Available
`E007`	ECO BANK	Multiful Update on BVN	update multiful page on the bvn...	₦20,000.00	Available
`E008`	ECO BANK	Correction of name and P/N	Correction of name and phone number	₦15,000.00	Available
`022`	Agency Banking	Correction of name	Correction of date of birth on...	₦6,500.00	Available
`023`	Agency Banking	Date of birth update	Correction of date of birth on...	₦6,000.00	Available
`024`	Agency Banking	Correction of name and date of birth	Correction of bvn name and date...	₦8,000.00	Available
`025`	Agency Banking	Phone Number Update	update bvn phone number know that...	₦6,000.00	Available
`026`	Agency Banking	Gender Update	Update BVN gender if the gender...	₦6,000.00	Available
`027`	Agency Banking	Bvn Revalidation	Revalidate bvn if the bvn information...	₦10,000.00	Available
`028`	Agency Banking	BVN full Alienment With ID	Update all bvn information to tally...	₦10,000.00	Available
`66`	Agency Banking	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`A109`	Agency Banking	Complete change of name	BVN complete change of name	₦60,000.00	Available
`55`	NIBSS BANKING	Date of birth update	Correction of date of birth on...	₦7,000.00	Available
`56`	NIBSS BANKING	Correction of name	Correction of name on the bvn...	₦7,000.00	Available
`57`	NIBSS BANKING	Phone number and email update	Correction of phon number and email...	₦7,000.00	Available
`58`	NIBSS BANKING	Date of birth and name update	Correction of date of birth and...	₦10,000.00	Available
`59`	NIBSS BANKING	Gender Update	Gender update on the bvn enrolled...	₦7,000.00	Available
`60`	NIBSS BANKING	BVN Revalidation	Bvn revalidation on the bvn that...	₦5,000.00	Available
`61`	NIBSS BANKING	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`48`	HERITAGE BANK	Date of birth update	correction of date of birth on...	₦7,000.00	Available
`49`	HERITAGE BANK	Correction of name	correction of name complete chance of...	₦7,000.00	Available
`50`	HERITAGE BANK	Phone number and email update	phone number update	₦7,000.00	Available
`51`	HERITAGE BANK	Date of birth and name update	correction of name and date of...	₦10,000.00	Available
`52`	HERITAGE BANK	Gender Update	gender update on the bvn	₦5,000.00	Available
`53`	HERITAGE BANK	BVN Revalidation	Bvn revalidation on the bvn that...	₦10,000.00	Available
`54`	HERITAGE BANK	Change of address	Change of bvn address residence address...	₦10,000.00	Available
`63`	HERITAGE BANK	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`41`	BANK OF AGRICULTURE	Date of birth update	Date of birth update on the...	₦7,000.00	Available
`42`	BANK OF AGRICULTURE	Correction of name	Correction of name update on the...	₦7,000.00	Available
`43`	BANK OF AGRICULTURE	Phone number and email update	Add or update bvn email and...	₦7,000.00	Available
`44`	BANK OF AGRICULTURE	Date of birth and name update	correction of name and date of...	₦10,000.00	Available
`46`	BANK OF AGRICULTURE	Gender Update	correction and gender update	₦7,000.00	Available
`47`	BANK OF AGRICULTURE	BVN Revalidation	bvn revalidation on bvn that is...	₦5,000.00	Available
`62`	BANK OF AGRICULTURE	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`67`	Keyston Bank	BVN Deletion Request	Request for bvn validation with an...	₦20,000.00	Available
`68`	Keyston Bank	Date of birth update	Correction of date of birth on...	₦8,000.00	Available
`69`	Keyston Bank	Correction of name	correction of name on the bvn...	₦15,000.00	Available
`70`	Keyston Bank	Phone number and email update	phone number and email update on...	₦8,000.00	Available
`71`	Keyston Bank	Date of birth and name update	Name and date of birtth update...	₦20,000.00	Available
`72`	Keyston Bank	Gender Update	gnder update	₦5,000.00	Available
`73`	Keyston Bank	BVN Revalidation	Bvn revalidation on the bvn that...	₦8,000.00	Available
`AC001`	Access Bank	Correction of Name	Correction of Name	₦15,000.00	Available
`AC002`	Access Bank	Date of Birth Update	Date of Birth Update	₦15,000.00	Available
`AC003`	Access Bank	Gender Update	Gender Update	₦15,000.00	Available
`AC004`	Access Bank	Phone Number and Email Update	Phone Number and Email Update	₦15,000.00	Available
`AC005`	Access Bank	Correction of Name and Date of Birth	Correction of Name and Date of...	₦20,000.00	Available
`AC006`	Access Bank	Complete Change of Name	Complete Change of Name	₦120,000.00	Available
`AC007`	Access Bank	Multiple Update on BVN	Multiple Update on BVN	₦20,000.00	Available
`AC008`	Access Bank	Correction of Name and Phone Number	Correction of Name and Phone Number	₦20,000.00	Available
`F001`	Fidelity Bank	Correction of Name	Correction of ecobank bvn on name	₦10,000.00	Available
`F002`	Fidelity Bank	Date of birth update	Correction of date of birth on...	₦10,000.00	Available
`F003`	Fidelity Bank	Gender Update	Correction of gender on bvn enrolled...	₦10,000.00	Available
`F004`	Fidelity Bank	Phone number and email update	Correction of email or phone of...	₦10,000.00	Available
`F005`	Fidelity Bank	Correction of name and date of birth	Correction of name and date of...	₦15,000.00	Available
`F006`	Fidelity Bank	Complete Change of name	Complete change of name on BVN	₦120,000.00	Available
`F007`	Fidelity Bank	Multiple Update on BVN	update multiple pages on the bvn...	₦20,000.00	Available
`F008`	Fidelity Bank	Correction of name and P/N	Correction of name and phone number	₦15,000.00	Available

Request Parameters (POST)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`field_code`	string	Authorized active field code from any banking pipeline (e.g. `003`).	Required
`bvn`	string	Valid 11-digit BVN to be modified.	Required
`nin`	string	Valid 11-digit NIN linked to the individual.	Required
`description`	string	Summary or specific reason for the modification, and the new informations we need on the BVN	Required
`modification_data`	object	Structured payload containing updated fields (e.g. `{"dob": "1995-05-12"}`).	Optional

Example Submit Request

cURL (POST)

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/bvn/modification" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "field_code": "003",
    "bvn": "22222222222",
    "nin": "12345678901",
    "description": "Write new information you need updated on the BVN"
  }'

Success Response (200 OK)

200 OK

{
  "status": "success",
  "code": 200,
  "message": "Request submitted, pending processing",
  "data": {
    "reference": "B14559R2DYP",
    "status": "pending",
    "bvn": "22222222222",
    "nin": "12345678901",
    "service": "Correction of name",
    "comment": "Your request is processing, it will be treated in 24 to 72h"
  }
}

Failed Response (400 Bad Request)

400 Bad Request

{
  "status": "failed",
  "code": 400,
  "message": "The selected field code is not authorized for BVN Modification requests."
}

Check BVN Modification Status

GET /api/v1/bvn/modification?bvn=22222222222

Query Parameters (GET)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`bvn`	string	The 11-digit BVN submitted with the modification.	Optional*
`reference`	string	The transaction reference returned upon submission (e.g. `B14559R2DYP`).	Optional*
`nin`	string	The 11-digit NIN submitted with the modification.	Optional*

* Note: You must provide at least one query parameter (bvn, reference, or nin) to retrieve the status.

Example Status Check Request

cURL (GET)

# Query by BVN:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/bvn/modification?bvn=22222222222" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# Alternatively query by Reference:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/bvn/modification?reference=B14559R2DYP" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Status Check Response (200 OK)

200 OK

// When completed:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "B14559R2DYP",
    "bvn": "22222222222",
    "nin": "12345678901",
    "service": "Correction of name",
    "status": "completed",
    "comment": "BVN modification completed successfully. Records updated on NIBSS database.",
    "description": "Correction of surname on BVN",
    "file_url": null,
    "submission_date": "2026-10-22 10:30:00"
  }
}

// When pending:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "B14559R2DYP",
    "bvn": "22222222222",
    "nin": "12345678901",
    "service": "Correction of name",
    "status": "pending",
    "comment": "Your request is processing, it will be treated in 24 to 72h",
    "description": "Correction of surname on BVN",
    "file_url": null,
    "submission_date": "2026-10-22 10:30:00"
  }
}