🔧Company Search

The API allows to get the following verified details of business - business registration, directors, shareholders, address and list of documents such as Incorporation, MemArts.

Company Search

POST https://<server_address>/api/companysearch

Headers

Name	Type	Description
Authorization*	String	Bearer <token>

Request Body

Name	Type	Description
country*	String	Must be provided as ISO3166 Alpha 3 Code
company_number*	String	Registered company number
company_type	String	Refer to below table

200: OK Response of company_type=plc

{
  "status": "success",
  "company_number": "",
  "request_time": "",
  "attributes": {
    "company_details": {
      "company_name": "",
      "registered_country": "",
      "company_number": "",
      "date_of_incorporation": "", //dd-MM-yyyy
      "company_type": "",
      "company_address": "",
      "nature_of_business": "",
      "share_capital": {
        "value": "", //this will be an empty string if the info is missing at URSB
        "currency": ""
      }
    },
    "directors": [
      {
        "name": "",
        "dob": "", //dd-MM-yyyy
        "date_appointed": "", //optional //dd-MM-yyyy
        "nationality": "" //optional
      }
    ],
    "shareholders": [
      {
        "shareholder": "",
        "no_of_shares": "100", // this will be an empty string if the info is missing at URSB
        "class_of_shares": "" //optional
      }
    ],
    "subscribers": [
      "George"
    ],
    "documents": [
      {
        "document_ref": "",
        "document_name": ""
      }
    ]
  }
}

200: OK Response of company_type=pf

{
    "status": "success",
    "company_number": "",
    "request_time": "",
    "attributes": {
        "company_details": {
            "company_name": "",
            "registered_country": "",
            "date_of_incorporation": "", //dd-MM-yyyy
            "company_type": "",
            "company_address": "" // possible empty/blank value 
        },
        "partners": [
            {
                "name": "",
                "dob": "",
                "nationality": "" // possible empty/blank value
            }
        ]
    }
}

// sample request body for companysearch
// country - must be provided as ISO 3166 Alpha 3 code 
// company_number - company registration number
// company_type - refer to the below table
// customer_id - customer ID provided by UNIFID
  {
    "country":"UGA",
    "company_number":"1045855",
    "company_type":"plc"
  }

For countries listed below company_type is mandatory and respective values must be provided.

Country	Company Type	Value
Uganda	Private Limited Company Public Company LLP	plc
Uganda	Proprietorship Partnership	pf