Skip to main content

Request

[GET]
{{baseURL}}/api/v1/zm/kyb/business
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
AuthorizationstringPrivate/secret key. Use <key> not Bearer <key>

Query parameter

ParameterTypeDescriptionRequired
entity_numberstringBusiness Numberrequired
entity_namestringBusiness Namerequired

Sample response

Response
{
    "entity": {
        "entity_name": "JOHN DOE INDUSTRIES LIMITED",
        "entity_type": "Local Company - Limited by Shares",
        "registration_number": "123456789091",
        "registration_date": "01/01/2021",
        "status": "Active",
        "nature_of_business": "Restaurants and mobile food service activities",
        "isic_classification": "5610. Restaurants and mobile food service activities",
        "isic_description": "Restaurants and mobile food service activities. This class includes the provision of food services to customers, whether they are served while seated or serve themselves from a display of items, whether they eat the prepared meals on the premises, take them out or have them delivered. This includes the preparation and serving of meals for immediate consumption from motorized vehicles or non-motorized carts.\r\n\r\nThis class includes activities of:\r\n- restaurants\r\n- cafeterias\r\n- fast-food restaurants\r\n- pizza delivery\r\n- take-out eating places\r\n- ice cream truck vendors\r\n- mobile food carts\r\n- food preparation in market stalls\r\n\r\nThis class also includes:\r\n- restaurant and bar activities connected to transportation, when carried out by separate units"
    }
}

Response Fields

FieldTypeDescription
entityobjectContains the business verification response data
entity.entity_namestringRegistered name of the business
entity.entity_typestringType of business entity (e.g., Local Company - Limited by Shares)
entity.registration_numberstringBusiness registration number
entity.registration_datestringDate of business registration in DD/MM/YYYY format
entity.statusstringCurrent status of the business (e.g., Active)
entity.nature_of_businessstringPrimary business activity description
entity.isic_classificationstringISIC industry classification code and label
entity.isic_descriptionstringDetailed description of the ISIC classification