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

Input

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' '

Code

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.

General info

{
  "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
      ]
  },

Ownership info

"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": "[e-mail]",
              "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": ""
          }
      }
  ],
  

Classification

"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
}