Validate businesses
Learn how to validate identification details of companies.
Overview
Verifying the identifications details provided by registered businesses is done by calling the business validation endpoints.
Depending on the details provided by the company, you can verify based on their RC details or TIN details by sending a POST
request to any of the business validation endpoints.
Using TIN Number
Validate and verify a company, when they provide their TIN number.
curl -X POST https://api.okra.ng/v2/products/kyc/tin-verify
-H 'Content-Type: application/json'
-d '{
{
"tin_number" : "String"// required,
"company_name", "String"// required,
}
}'
{
"status": "String (success || fail)",
"message": "Company TIN Verified",
"data": {
"status": boolean,
"message": "String",
"details": {
"tax_no": "String",
"tax_payer_name": "String",
"tax_payer_phone": "String",
"tax_payer_email": "String",
"tax_authority": "String",
"tax_authority_phone": "String",
"tax_authority_email": "String"
}
}
}
Using RC Number
Validate a company's authenticity, when they provide their RC number.
curl -X POST https://api.okra.ng/v2/products/kyc/rc-verify
-H 'Content-Type: application/json'
-d ' {
rc_number, //required
company_name, // required
success, //optional boolean (for testing)
testing,//option boolean (for testing)
}'
{
"status": "String (success || fail)",
"message": "String",
"data": {
"status": boolean,
"message": "String",
"details": {
"rc_no": "String",
"company_name": "String",
"address": "String",
"date_reg": "String"
}
}
}
RC/TIN
Combine the TIN and RC endpoints to retrieve comprehensive details of a company.
curl -X POST https://api.okra.ng/v2/products/kyc/rc-tin-verify
-H 'Content-Type: application/json'
-d '{
"currency" : String,
"rc_number" : String,
"company_name" : String,
"tin_number" : "String
}'
{
"status": "success",
"message": "Identity succesfully retrieved",
"data": {
"identity": {
"fullname": "GAVIN BELSON",
"id": "xxxxxxxxxxxxxxxx",
"bvn": "12331106253",
"score": "0",
"env": "production",
"created_at": "2019-12-14T13:46:53.415Z",
"last_updated": "2021-01-26T10:14:56.300Z",
"aliases": [],
"customer": {
"_id": "xxxxxxxxxxxxxxxx",
"name": "GAVIN BELSON"
},
"dob": "1979-09-27",
"gender": "M",
"middlename": "MIDDLENAME",
"firstname": "GAVIN",
"lastname": "BELSON",
"phone": [
"2347088793567"
],
"email": [],
"address": [
"4 AKANNI BASHORUN,LEKKI LAGOS"
],
"verified": true,
"photo_id": [{..photo data..}
],
"status": "failed"
},
"customer": "xxxxxxxxxxxxxxxx",
"account": "xxxxxxxxxxxxxxxx",
},
.........
}
}
Check out the Identity API Reference
Updated about 2 months ago
Did this page help you?