Certificate of Incorporation (CAC) Verification

CAC Lookup API

To perform a verification on a business's certificate of incorporation, make a POST request to the following endpoint;

https://api.korapay.com/merchant/api/v1/identities/ng/cac


The request body should have the following parameters:

{
   "id": "RC00000011",
   "verification_consent": true
}

The fields in this request include:

FieldData TypeDescription
idStringRequired - the ID number
registration_nameStringOptional - the registered name of the business
verification_consentBooleanRequired - this indicates that subject has given consent to perform this verification. This must be true for the check to be performed.

The response to this request would look like this:

{
   "status": true,
   "message": "CAC verified successfully",
   "data": {
       "reference": "VR-TCGSjd4tgYaquSE20",
       "id": "RC00000011",
       "id_type": "ng_cac",
       "name": "John Doe Inc",
       "email": "[email protected]",
       "phone_number": "+1 000 000 0000",
       "search_business_name": null,
       "former_name": null,
       "brand_name": null,
       "registration_number": "RC00000000",
       "registry_number": "00000000",
       "vat_number": "00000000-0001",
       "registration_date": "2017-06-09T00:00:00.000+00:00",
       "registration_submission_date": "2017-05-31T11:22:07.713+00:00",
       "date_dissolved": null,
       "tin": "00000000-0001",
       "jtb_tin": null,
       "tax_office": null,
       "website_email": null,
       "type_of_entity": "PRIVATE COMPANY LIMITED BY SHARES",
       "activity": "Information service activities",
       "address": "1ST FLOOR,SUM HOUSE,Fake Street",
       "state": "LAGOS",
       "lga": "Lagos Mainland",
       "city": "YABA",
       "branch_address": "1ST FLOOR,SUM HOUSE,Fake Street, YABA, LAGOS STATE ",
       "head_office_address": null,
       "objectives": "",
       "company_status": "ACTIVE",
       "last_updated_at": "2022-03-30T14:19:35.571+00:00",
       "share_capital_in_words": "TEN MILLION NAIRA",
       "paid_share_capital": "10000000",
       "subscribed_share_capital": "10000000",
       "shares_value": "0.01 NGN",
       "activity_description": "Information service activities",
       "shares_issued": "10000000",
       "parent_country": null,
       "company_contact_persons": [
           {
               "contacts": {
                   "email": [
                       "[email protected]"
                   ],
                   "phone": [
                       "08034926354"
                   ]
               },
               "name": "Eboikpomwen  Eki "
           }
       ],
       "country": "ng",
       "key_personnel": [
           {
               "name": "PETER DOE",
               "designation": "WITNESS",
               "is_corporate": false,
               "appointed_on": null,
               "resigned_on": null,
               "shares_type": "",
               "shares_value": null,
               "shares_count": null,
               "occupation": "LAWYER",
               "nationality": null,
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": "",
               "address": "8C, NONE STREET, ZONE 4",
               "country_of_residence": "NIGERIA",
               "number": "",
               "is_foreign": "false",
               "document_type": "",
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": "",
               "email": "",
               "phone_number": "",
               "status": "ACTIVE",
               "companies": []
           },
           {
               "name": "SUSAN DOE",
               "designation": "SECRETARY_COMPANY",
               "is_corporate": false,
               "appointed_on": null,
               "resigned_on": null,
               "shares_type": "",
               "shares_value": null,
               "shares_count": null,
               "occupation": "SECRETARY",
               "nationality": "NIGERIA",
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": "FEMALE",
               "address": "11, NONE CRESCENT",
               "country_of_residence": "NIGERIA",
               "number": "",
               "is_foreign": "false",
               "document_type": "",
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": "",
               "email": "",
               "phone_number": "",
               "status": "ACTIVE",
               "companies": []
           },
           {
               "name": "MICHAEL DOE",
               "designation": "DIRECTOR",
               "is_corporate": null,
               "appointed_on": null,
               "resigned_on": null,
               "shares_type": null,
               "shares_value": null,
               "shares_count": null,
               "occupation": "BUSINESS",
               "nationality": "NIGERIA",
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": "MALE",
               "address": "1, NONE STREET, ",
               "country_of_residence": "NIGERIA",
               "number": null,
               "is_foreign": "false",
               "document_type": null,
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": null,
               "email": null,
               "phone_number": null,
               "status": "ACTIVE",
               "companies": []
           },
           {
               "name": "JANE DOE  INC",
               "designation": "SHAREHOLDER",
               "is_corporate": true,
               "appointed_on": "2021-03-17T14:07:43.000+00:00",
               "resigned_on": null,
               "shares_type": "ORDINARY",
               "shares_value": "9990000",
               "shares_count": "9990000",
               "occupation": null,
               "nationality": null,
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": null,
               "address": "01 COASTAL HIGHWAY,LEWES DE 000000  USA,COUNTY OF SUSSEX",
               "country_of_residence": "UNITED STATES",
               "number": null,
               "is_foreign": "true",
               "document_type": null,
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": null,
               "email": null,
               "phone_number": null,
               "status": "ACTIVE",
               "companies": []
           },
           {
               "name": "JOHN DOE",
               "designation": "SHAREHOLDER",
               "is_corporate": null,
               "appointed_on": null,
               "resigned_on": null,
               "shares_type": "ORDINARY",
               "shares_value": "10000",
               "shares_count": "10000",
               "occupation": null,
               "nationality": null,
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": "MALE",
               "address": "1 NONE STREET,LEKKI",
               "country_of_residence": "NIGERIA",
               "number": null,
               "is_foreign": "false",
               "document_type": null,
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": null,
               "email": null,
               "phone_number": null,
               "status": "ACTIVE",
               "companies": []
           },
           {
               "name": "JOHN DOE INC",
               "designation": "PERSONS WITH SIGNIFICANT CONTROL",
               "is_corporate": true,
               "appointed_on": "2022-03-30T14:42:16.554+00:00",
               "resigned_on": null,
               "shares_type": null,
               "shares_value": null,
               "shares_count": null,
               "occupation": null,
               "nationality": null,
               "birth_year": null,
               "birth_month": null,
               "birth_date": null,
               "date_of_birth": null,
               "gender": null,
               "address": "01 COASTAL HIGHWAY,LEWES DE 000000 ",
               "country_of_residence": "UNITED STATES",
               "number": null,
               "is_foreign": "true",
               "document_type": null,
               "document_issued_by": null,
               "document_issued_on": null,
               "document_number": null,
               "email": null,
               "phone_number": null,
               "status": "ACTIVE",
               "companies": []
           }
       ],
       "activities": [],
       "legal_entity_identifier_register": [
           {
               "legal_entity_identifier_code": "0000000000000000",
               "legal_name": "John Doe PLC",
               "legal_first_address_line": "1 FAKE CRICK AVENUE",
               "legal_additional_address_line_1": "CAMBRIDGE BIOMEDICAL CAMPUS",
               "legal_additional_address_line_2": "",
               "legal_additional_address_line_3": "",
               "legal_address_city": "CAMBRIDGE",
               "legal_address_region": "GB-CAM",
               "legal_address_country": "GB",
               "legal_address_postal_code": "CB2 0AA",
               "registration_authority_id": "R0000000",
               "registration_authority_entity_id": "00000000",
               "legal_jurisdiction": "GB",
               "entity_category": "GENERAL",
               "initial_registration_date": "2012-06-06",
               "registration_last_update_date": "2021-08-21",
               "registration_next_renewal_date": "2022-08-11",
               "registration_managing_lou": "0000000000000000",
               "registration_validation_sources": "FULLY_CORROBORATED",
               "validation_authority_id": "RA000000",
               "validation_authority_entity_id": "02700000",
               "entity_status": "ACTIVE",
               "status": "ISSUED"
           }
       ],
       "central_index_key_register": [
           {
               "cik": "000000",
               "entity_type": "operating",
               "sic": "3711",
               "sic_description": "Motor Vehicles & Passenger Car Bodies",
               "name": "John Doe, Inc.",
               "ein": "000000000000",
               "description": "",
               "website": "",
               "investor_website": "",
               "tickers": [
                   "JOL"
               ],
               "state_of_incorporation": "DE",
               "business_address_street_1": "3500 FAKE ST ROAD",
               "mailing_address_city": "PALO ALTO",
               "business_address_street_2": null,
               "business_address_city": "PALO ALTO",
               "business_address_state_or_country": "CA",
               "business_address_zip_code": "123454",
               "business_address_state_or_country_description": "CA",
               "phone_number": "000-000-0000",
               "former_names": [
                   {
                       "from": "2005-02-17T00:00:00.000Z",
                       "to": "2017-01-27T00:00:00.000Z",
                       "name": "JOL MOTORS INC"
                   }
               ]
           }
       ],
       "filings": [
           {
               "date": "2020-10-31",
               "name": "Dissolution",
               "type": "Dissolution",
               "status": null,
               "type_code": null
           },
           {
               "date": "2017-09-27",
               "name": "Incorporation",
               "type": "Incorporation",
               "status": null,
               "type_code": null
           }
       ],
       "affiliates": [
           {
               "name": "John Doe 1",
               "brand_name": null,
               "short_name": null,
               "company_number": "0000.000.000",
               "country": "NG"
           },
           {
               "name": "John Doe 2",
               "brand_name": null,
               "short_name": null,
               "company_number": "0000.000.0000",
               "country": "NG"
           }
       ],
       "search_term": "RC00000011",
       "requested_by": "API User"
   }
}