Skip to main content
API docs by Redocly

MeVerify API Services (1.0.0)

Download OpenAPI specification:Download

API for MEV (MVerify) KYC/AML verification services

BVN

Bank Verification Number operations

Verify BVN information match

Verify if provided personal information matches the BVN record

Authorizations:
None
Request Body schema: application/json
required
bvn
required
string

Bank Verification Number (BVN) of the user.

firstname
required
string

First name of the BVN user.

lastname
required
string

Last name of the BVN user.

phone
string or null

Phone number of the BVN user.

dob
string or null <date>

Date of birth of the BVN user.

gender
string or null

Gender you want to match with BVN (optional).

email
string or null <email>

Email you want to match with BVN (Optional).

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
required
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "bvn": "22322090542",
  • "firstname": "john",
  • "lastname": "doe",
  • "phone": "string",
  • "dob": "2019-08-24",
  • "gender": "string",
  • "email": "user@example.com",
  • "refresh": true,
  • "simulate_success": true
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Request successful",
  • "status": true,
  • "data": {
    }
}

NIN

National Identity Number operations

Verify NIN information (mini)

Verify if provided personal information matches the NIN record (basic verification)

Authorizations:
None
Request Body schema: application/json
required
nin
required
string

National Identity Number to verify

firstname
required
string

First name to match with NIN record

lastname
required
string

Last name to match with NIN record

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
required
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "nin": "18069759727",
  • "firstname": "babatunde",
  • "lastname": "dawodu",
  • "refresh": true,
  • "simulate_success": true
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Request successful",
  • "status": true,
  • "data": {
    }
}

CAC

Corporate Affairs Commission operations

Basic CAC verification

Verify basic company information with CAC

Authorizations:
None
Request Body schema: application/json
required
regNumber
required
string

Company registration number

type
required
string

Type of company (e.g., REGISTERED_COMPANY)

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "regNumber": "1886946",
  • "type": "REGISTERED_COMPANY",
  • "refresh": true,
  • "simulate_success": true
}

CAC verification with TIN

Verify company information with CAC including TIN (Tax Identification Number)

Authorizations:
None
Request Body schema: application/json
required
regNumber
required
string

Company registration number

type
required
string

Type of company (e.g., REGISTERED_COMPANY)

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "regNumber": "1886946",
  • "type": "REGISTERED_COMPANY",
  • "refresh": true,
  • "simulate_success": true
}

CAC verification with TIN (Provide TIN)

Verify company information with CAC including TIN (Tax Identification Number) with extended data

Authorizations:
None
Request Body schema: application/json
required
regNumber
required
string

Tax Identification Number (TIN)

type
required
string

Type of company (e.g., REGISTERED_COMPANY)

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "regNumber": "188694676859549",
  • "type": "REGISTERED_COMPANY",
  • "refresh": true,
  • "simulate_success": true
}

Premium CAC verification

Verify company information with CAC (premium version)

Authorizations:
None
Request Body schema: application/json
required
regNumber
required
string

Company registration number

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "regNumber": "RC1899964",
  • "refresh": true,
  • "simulate_success": true
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Request successful",
  • "status": true,
  • "data": {
    }
}

Premium CAC verification (expanded)

Verify company information with CAC (premium expanded version)

Authorizations:
None
Request Body schema: application/json
required
regNumber
required
string

Company registration number

refresh
required
boolean

Boolean flag indicating if data should be refreshed.

simulate_success
boolean

Boolean flag to simulate a successful response (If in sandbox mode).

Responses

Request samples

Content type
application/json
{
  • "regNumber": "RC1899964",
  • "refresh": true,
  • "simulate_success": true
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Request successful",
  • "status": true,
  • "data": {
    }
}