BVN Phone Search API

Lookup linked Bank Verification Number (BVN) and identity records using an active Nigerian phone number.

Service Online / Available

POST /api/v1/bvn/phone-search

Authentication & Headers

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

Authorized Field Codes & Realtime Pricing

Role: Default

FIELD CODE	SERVICE NAME	DESCRIPTION	PRICE (₦)	STATUS
`45`	Search BVN	Search bvn using phone number know...	₦1,300.00	Available

Request Parameters (POST)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`field_code`	string	Authorized active field code (e.g. `45`).	Required
`phone_number`	string	Valid 10 or 11-digit Nigerian phone number (e.g. `08012345678`).	Required

Example Submit Request

cURL (POST)

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/bvn/phone-search" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "field_code": "45",
    "phone_number": "08012345678"
  }'

Success Response (200 OK)

200 OK

{
  "status": "success",
  "code": 200,
  "message": "Request submitted, pending processing",
  "data": {
    "reference": "BVNS4559R2DYP",
    "status": "pending",
    "phone_number": "08012345678",
    "service": "Search BVN",
    "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 Phone Search requests."
}

Check Phone Search Status

GET /api/v1/bvn/phone-search?phone_number=08012345678

Query Parameters (GET)

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`phone_number`	string	The phone number submitted with the request.	Optional*
`reference`	string	The transaction reference returned upon submission (e.g. `BVNS4559R2DYP`).	Optional*

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

Example Status Check Request

cURL (GET)

# Query by Phone Number:
curl -X GET "https://www.api.arewasmart.com.ng/api/v1/bvn/phone-search?phone_number=08012345678" \
  -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/phone-search?reference=BVNS4559R2DYP" \
  -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": "BVNS4559R2DYP",
    "phone_number": "08012345678",
    "bvn": "22222222222",
    "service": "Search BVN",
    "status": "completed",
    "comment": "BVN phone search completed successfully.",
    "file_url": null,
    "submission_date": "2026-10-22 10:30:00"
  }
}

// When pending:
{
  "status": "success",
  "code": 200,
  "message": "Status checked.",
  "data": {
    "reference": "BVNS4559R2DYP",
    "phone_number": "08012345678",
    "bvn": null,
    "service": "Search BVN",
    "status": "pending",
    "comment": "Your request is processing, it will be treated in 24 to 72h",
    "file_url": null,
    "submission_date": "2026-10-22 10:30:00"
  }
}