> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup Zambia Business

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

<div className="dj-endpoint">
  <span className={`dj-method dj-method-get`}>GET</span>
  <code>/api/v1/zm/kyb/business</code>
</div>

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](/api-reference/core-concepts/wallet-billing). |
| `404` | No record found for the supplied identifier.                                                  |
| `429` | Too many requests — back off and retry.                                                       |

<RequestExample>
  ```bash cURL theme={null}
  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}}"
  ```

  ```js Node.js theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</RequestExample>

<ResponseExample>
  ```json GET /api/v1/zm/kyb/business theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>