> ## 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.

# Global Business Search

> Search for businesses across global commercial registries by name or registration number. Returns a list of matching companies.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/kyb/business/search
```

### Header

| Header        | Type   | Description                                                                                             |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on the dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                      |

### Query Parameters

| Parameter        | Type   | Description                                         | Required |
| ---------------- | ------ | --------------------------------------------------- | -------- |
| name \*          | string | Business name to search for (partial or full match) | required |
| country\_code \* | string | Country code of the business's country              | required |

### Sample response

```json Response theme={null}
{
    "entity": [
        {
            "name": "ABCD GLOBAL INDUSTRIES LTD",
            "internationalNumber": "200045678",
            "country": {
                "name": "Exampleland",
                "code": "EX"
            }
        },
        {
            "name": "ABCD HOLDINGS PLC",
            "internationalNumber": "200098765",
            "country": {
                "name": "Exampleland",
                "code": "EX"
            }
        }
    ]
}
```

### Response Fields

| Field                         | Type   | Description                                                                                                                                                                    |
| ----------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| entity                        | array  | List of matching businesses                                                                                                                                                    |
| entity\[].name                | string | Registered name of the business                                                                                                                                                |
| entity\[].internationalNumber | string | International registration number (use this with the [Global Business Details](/docs/globalverification/businesscheck/global-business-details) endpoint to fetch full profile) |
| entity\[].country             | object | Country details for the business registration                                                                                                                                  |
| entity\[].country.name        | string | Name of the country or region                                                                                                                                                  |
| entity\[].country.code        | string | Country or region code                                                                                                                                                         |
