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


Did this page help you?