Main API Docs
  • Welcome!
  • General
    • Introduction
    • Authentication
    • Personal Access Tokens
    • Test IDs
    • Check Wallet Balance
  • Appruve Identity
    • Introduction
    • Ghana 🇬🇭
      • Verify Ghana TIN
      • Verify Ghana Driver License
      • Verify Ghana SSNIT ID
      • Verify Ghana Passport
      • Verify Ghana Voter ID
      • Verify Ghana Digital Address
    • Nigeria 🇳🇬
      • Verify Nigeria TIN
      • Verify Nigeria Driver License
      • Verify Nigeria NIN
      • Verify Nigeria vNIN
      • Verify Nigeria Voter ID
      • Verify Nigeria BVN
    • Kenya 🇰🇪
      • Verify Kenya KRA PIN
      • Verify Kenya National ID
    • Uganda 🇺🇬
      • Verify Uganda Voter ID
      • Verify Uganda Telco Subscriber
      • BulK Uganda Telco Subscriber Verification
  • Appruve Business
    • Introduction
    • Business Lookups
      • Nigeria 🇳🇬
        • Lookup with CAC number
        • Lookup using Tax ID (TIN)
      • Uganda Business Lookup 🇺🇬
      • Ghana Business Lookup 🇬🇭
    • Business Beneficial Ownership
      • Nigeria 🇳🇬
  • Appruve Agency
    • OCR For Sequential Verification
      • Senegal 🇸🇳
      • Nigeria 🇳🇬
      • Ghana 🇬🇭
      • Kenya 🇰🇪
      • Côte d'Ivoire 🇨🇮
      • Cameroon 🇨🇲
    • Standalone OCR
      • Nigeria 🇳🇬
      • Ghana 🇬🇭
      • Kenya 🇰🇪
      • Côte d'Ivoire 🇨🇮
      • Cameroon 🇨🇲
      • Senegal 🇸🇳
    • Perform Face Matching
    • Upload Selfie Photo
    • Get Liveness Detection Challenge
    • Verify Liveness Detection Challenge
    • Confirm Extracted ID Number
    • Verify Business Document By OCR
    • Verify Nigeria vNIN with selfie
  • Guides
    • Webhooks
    • ID Document to Selfie Matching
  • Mobile Sdks
    • Android SDK
    • iOS SDK
  • Resources
    • Country Codes
    • ID Types
    • Face Liveness Check
Powered by GitBook
On this page
  1. Appruve Business
  2. Business Beneficial Ownership

Nigeria 🇳🇬

Running a beneficial ownership search on a Nigerian entity.

To run a beneficial ownership search on a Nigerian entity, one needs either the Registration number or Entity name.When looking up a Nigerian entity using their CAC number, omit the "RC" (for Corporate entities) or the "BN" (for Enterprises) that comes before the CAC number. For example "RC1234567" would be "1234567".

POST https://api.appruve.co/v1/verifications/ng/beneficial_ownership_info

Object

Type

Status

Description

search_term

string

required

This can be any of the entity's parameters e.g a name 'test co', or a registration number '12809000003' '

curl --location --request POST 'https://api.appruve.co/v1/verifications/ng/beneficial_ownership_info' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data-raw '{
    "search_term": "1234567"
}'

The response to this request is divided into four major pieces of information:

  1. General Company and Share allocation information: This object contains general entity information and how entity shares are allocated across shareholders.

  2. Beneficial owner information: This object gives details of each beneficial owner associated with the entity. It shows each entity shareholder, general information about them and their role in the business.

  3. Precise Address: This object gives precise details of the entity's registered address and can be used as a "place_id" in a google maps API query.

  4. Classification: This object classifies the entity according to what it does / what industry it operates and returns all possible industries the company operates and a probability score attached to each.

{
  "company_id": "1234567",
  "company_name": "JOHN DOE TECHNOLOGIES LTD",
  "company_status": "INACTIVE",
  "company_registration": "1234567",
  "company_commencement_date": "2017-02-22",
  "company_type_info": "PRIVATE COMPANY LIMITED BY SHARES",
  "company_email": null,
  "company_address": "21 JANE STREET, OFF JOHN AVENUE, ILUPEJU",
  "company_address_city": "LAGOS",
  "company_address_state": "LAGOS",
  "company_objectives": "TO MAKE THE WORLD A BETTER PLACE",
  "company_address_details": {
      "company_formatted_address": "21 Jane St, Ilupeju, Lagos, Nigeria",
      "commpany_place_id": "ggoogle place id",
      "commpany_coordinates": [
          5.7194174,
          -0.1951565
      ]
  },
"company_beneficial_owner_information": [
      {
          "entity_type": "individual",
          "name": "JONAS DOE",
          "role": "SHAREHOLDER",
          "details": {
              "id": 123456,
              "address": "12B, JANE STREET, ILUPEJU",
              "city": "LAGOS",
              "country_of_residence": "NIGERIA",
              "gender": "Female",
              "nationality": "Nigerian",
              "occupation": "",
              "share_percentage": 15.0,
              "shares_allotted": 150000,
              "status": "ACTIVE",
              "type_of_shares": "Ordinary",
              "email": "",
              "phone": "",
              "date_of_birth": "1900-10-16",
              "id_type": "Driver's License",
              "id_number": "G000000000"
          },
          "name_elements": {
              "full_name": "JONAS DOE",
              "first_name": "JONAS",
              "last_name": "DOE",
              "middle_name": "",
              "former_name": "",
              "entity_name": ""
          }
      },
      {
          "entity_type": "individual",
          "name": "MIKE DOE",
          "role": "",
          "details": {
              "id": 1234567,
              "address": "NO 33, JANE STREET ILUPEJU",
              "city": "",
              "country_of_residence": "",
              "gender": "",
              "nationality": "",
              "occupation": "",
              "share_percentage": 0.0,
              "shares_allotted": 0,
              "status": "ACTIVE",
              "type_of_shares": "",
              "email": "mike.doe@yahoo.com",
              "phone": "000000000000",
              "date_of_birth": "",
              "id_type": "",
              "id_number": ""
          },
          "name_elements": {
              "full_name": "MIKE DOE",
              "first_name": "MIKE",
              "last_name": "DOE",
              "middle_name": "",
              "former_name": "",
              "entity_name": ""
          }
      }
  ],
  
"company_true_classification": [
      {
          "industry": "providers",
          "probability": 0.3333333432674408
      },
      {
          "industry": "advisory",
          "probability": 0.3333333432674408
      },
      {
          "industry": "ideas",
          "probability": 0.3333333432674408
      }
  ],
  "company_address_on_map": true,
  "company_total_issued_shares": 1000000
}
PreviousBusiness Beneficial OwnershipNextOCR For Sequential Verification

Last updated 3 years ago