Main API Docs
Searchโ€ฆ
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".
1
POST https://api.appruve.co/v1/verifications/ng/beneficial_ownership_info
Copied!
Input
Code
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' '
1
curl --location --request POST 'https://api.appruve.co/v1/verifications/ng/beneficial_ownership_info' \
2
--header 'Authorization: Bearer <API_TOKEN>' \
3
--data-raw '{
4
"search_term": "1234567"
5
}'
Copied!
The response to this request is divided into four major pieces of information:
  1. 1.
    General Company and Share allocation information: This object contains general entity information and how entity shares are allocated across shareholders.
  2. 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. 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. 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
Ownership info
Classification
1
{
2
"company_id": "1234567",
3
"company_name": "JOHN DOE TECHNOLOGIES LTD",
4
"company_status": "INACTIVE",
5
"company_registration": "1234567",
6
"company_commencement_date": "2017-02-22",
7
"company_type_info": "PRIVATE COMPANY LIMITED BY SHARES",
8
"company_email": null,
9
"company_address": "21 JANE STREET, OFF JOHN AVENUE, ILUPEJU",
10
"company_address_city": "LAGOS",
11
"company_address_state": "LAGOS",
12
"company_objectives": "TO MAKE THE WORLD A BETTER PLACE",
13
"company_address_details": {
14
"company_formatted_address": "21 Jane St, Ilupeju, Lagos, Nigeria",
15
"commpany_place_id": "ggoogle place id",
16
"commpany_coordinates": [
17
5.7194174,
18
-0.1951565
19
]
20
},
Copied!
1
"company_beneficial_owner_information": [
2
{
3
"entity_type": "individual",
4
"name": "JONAS DOE",
5
"role": "SHAREHOLDER",
6
"details": {
7
"id": 123456,
8
"address": "12B, JANE STREET, ILUPEJU",
9
"city": "LAGOS",
10
"country_of_residence": "NIGERIA",
11
"gender": "Female",
12
"nationality": "Nigerian",
13
"occupation": "",
14
"share_percentage": 15.0,
15
"shares_allotted": 150000,
16
"status": "ACTIVE",
17
"type_of_shares": "Ordinary",
18
"email": "",
19
"phone": "",
20
"date_of_birth": "1900-10-16",
21
"id_type": "Driver's License",
22
"id_number": "G000000000"
23
},
24
"name_elements": {
25
"full_name": "JONAS DOE",
26
"first_name": "JONAS",
27
"last_name": "DOE",
28
"middle_name": "",
29
"former_name": "",
30
"entity_name": ""
31
}
32
},
33
{
34
"entity_type": "individual",
35
"name": "MIKE DOE",
36
"role": "",
37
"details": {
38
"id": 1234567,
39
"address": "NO 33, JANE STREET ILUPEJU",
40
"city": "",
41
"country_of_residence": "",
42
"gender": "",
43
"nationality": "",
44
"occupation": "",
45
"share_percentage": 0.0,
46
"shares_allotted": 0,
47
"status": "ACTIVE",
48
"type_of_shares": "",
49
"email": "[email protected]",
50
"phone": "000000000000",
51
"date_of_birth": "",
52
"id_type": "",
53
"id_number": ""
54
},
55
"name_elements": {
56
"full_name": "MIKE DOE",
57
"first_name": "MIKE",
58
"last_name": "DOE",
59
"middle_name": "",
60
"former_name": "",
61
"entity_name": ""
62
}
63
}
64
],
65
Copied!
1
"company_true_classification": [
2
{
3
"industry": "providers",
4
"probability": 0.3333333432674408
5
},
6
{
7
"industry": "advisory",
8
"probability": 0.3333333432674408
9
},
10
{
11
"industry": "ideas",
12
"probability": 0.3333333432674408
13
}
14
],
15
"company_address_on_map": true,
16
"company_total_issued_shares": 1000000
17
}
Copied!
Copy link