Lookup Zambia Business - Dojah Inc

curl --request GET \
  "https://api.dojah.io/api/v1/zm/kyb/business?entity_number=123456789091&entity_name=JOHN%20DOE%20INDUSTRIES%20LIMITED" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "entity_number": "123456789091",
  "entity_name": "JOHN DOE INDUSTRIES LIMITED",
});

const url = "https://api.dojah.io/api/v1/zm/kyb/business?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/zm/kyb/business",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "entity_number": "123456789091",
        "entity_name": "JOHN DOE INDUSTRIES LIMITED",
    },
)
data = res.json()

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

GET/api/v1/zm/kyb/business

Verify a Zambian business by its registration number and name, and retrieve its registered company details and nature of business.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

Query parameters

Parameter	Type	Required	Description
`entity_number`	string	Yes	The business registration number.
`entity_name`	string	Yes	The registered business name.

Response

Returns an entity with the business’s name, type, registration details, status, and nature of business.

Errors

Code	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`404`	No record found for the supplied identifier.
`429`	Too many requests — back off and retry.

curl --request GET \
  "https://api.dojah.io/api/v1/zm/kyb/business?entity_number=123456789091&entity_name=JOHN%20DOE%20INDUSTRIES%20LIMITED" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "entity_number": "123456789091",
  "entity_name": "JOHN DOE INDUSTRIES LIMITED",
});

const url = "https://api.dojah.io/api/v1/zm/kyb/business?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/zm/kyb/business",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "entity_number": "123456789091",
        "entity_name": "JOHN DOE INDUSTRIES LIMITED",
    },
)
data = res.json()

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