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

> Retrieve a company's full profile from international business registries using its registration number and country code. Returns corporate details including registered name, incorporation date, addresses, share capital, associated persons, business activities, and registry source information.

### Request

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

### 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 |
| ------------------------ | ------ | ------------------------------------------------ | -------- |
| international\_number \* | string | International/registration number of the company | 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",
        "localNumber": "1234345678",
        "dateCreated": "2005-03-15",
        "address": "123 Commerce Avenue, Central District, Metropolis",
        "paidShareCapital": "",
        "sharesValue": "",
        "sharesIssued": "",
        "activityDescription": "",
        "oldInternationalNumber": "",
        "country": {
            "name": "Exampleland",
            "code": "EX",
            "currency": "EXD",
            "sources": [
                {
                    "url": "https://registry.example.com/",
                    "name": "Exampleland Office of the Registrar General"
                }
            ]
        },
        "type": {
            "type": "",
            "isIndividual": false
        },
        "statuses": [],
        "activities": [],
        "parentCountry": "EX",
        "addresses": [
            {
                "address": "123 Commerce Avenue, Central District, Metropolis",
                "companies": []
            }
        ],
        "persons": [],
        "companyContacts": {
            "email": []
        },
        "personsCount": 0,
        "companyContactsCount": 0,
        "business": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
}
```

### Response Fields

| Field                                       | Type            | Description                                                         |
| ------------------------------------------- | --------------- | ------------------------------------------------------------------- |
| entity                                      | object          | Contains the business details                                       |
| entity.name                                 | string          | Registered name of the business                                     |
| entity.internationalNumber                  | string          | International registration number                                   |
| entity.localNumber                          | string          | Local registration number                                           |
| entity.dateCreated                          | string          | Date the business was created (ISO 8601 format)                     |
| entity.address                              | string          | Primary registered address                                          |
| entity.paidShareCapital                     | string          | Total paid-up share capital with currency                           |
| entity.sharesValue                          | string          | Value per share with currency                                       |
| entity.sharesIssued                         | string          | Total number of shares issued                                       |
| entity.activityDescription                  | string          | Description of business activities                                  |
| entity.oldInternationalNumber               | string          | Previous international registration number                          |
| 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                                              |
| entity.country.currency                     | string          | Currency code (e.g., "USD")                                         |
| entity.country.sources                      | array           | List of registry data sources                                       |
| entity.country.sources\[].url               | string          | URL of the data source                                              |
| entity.country.sources\[].name              | string          | Name of the data source                                             |
| entity.type                                 | object          | Business entity type details                                        |
| entity.type.type                            | string          | Type of business entity (e.g., "Private company limited by shares") |
| entity.type.isIndividual                    | boolean         | Whether the entity is registered as an individual                   |
| entity.statuses                             | array           | List of business statuses                                           |
| entity.statuses\[].providerId               | string          | Status identifier from the provider                                 |
| entity.statuses\[].providerName             | string          | Status display name from the provider                               |
| entity.activities                           | array           | List of business activities                                         |
| entity.activities\[].providerId             | string          | Activity identifier from the provider                               |
| entity.activities\[].providerName           | string          | Activity description from the provider                              |
| entity.activities\[].createdAt              | string          | Date the activity record was created (ISO 8601 format)              |
| entity.activities\[].type                   | object          | Activity type classification                                        |
| entity.activities\[].type.id                | number          | Activity type ID                                                    |
| entity.activities\[].type.name              | string          | Activity type name (e.g., "Primary")                                |
| entity.parentCountry                        | string \| null  | Parent country code if applicable (e.g., "EX")                      |
| entity.addresses                            | array           | List of registered addresses                                        |
| entity.addresses\[].address                 | string          | Full address string                                                 |
| entity.addresses\[].companies               | array           | Associated companies at this address                                |
| entity.persons                              | array           | List of persons associated with the business                        |
| entity.persons\[].sourceNum                 | number          | Source number reference                                             |
| entity.persons\[].person                    | object          | Person details                                                      |
| entity.persons\[].person.id                 | string \| null  | Person identifier                                                   |
| entity.persons\[].person.name               | string \| null  | Person's full name                                                  |
| entity.persons\[].person.countryId          | number          | Country ID reference                                                |
| entity.persons\[].person.occupation         | string \| null  | Person's occupation                                                 |
| entity.persons\[].person.nationality        | string \| null  | Person's nationality                                                |
| entity.persons\[].person.address            | string \| null  | Person's address                                                    |
| entity.persons\[].person.countryOfResidence | string \| null  | Person's country of residence                                       |
| entity.persons\[].person.honorific          | string \| null  | Person's honorific or title                                         |
| entity.persons\[].person.number             | string          | Person's registration number                                        |
| entity.persons\[].person.isForeign          | boolean \| null | Whether the person is a foreign national                            |
| entity.persons\[].person.hideAddress        | boolean \| null | Whether the person's address is hidden                              |
| entity.persons\[].person.email              | string \| null  | Person's email address                                              |
| entity.persons\[].person.phone              | string \| null  | Person's phone number                                               |
| entity.persons\[].person.countryCode        | string          | Person's country code                                               |
| entity.persons\[].role                      | object          | Person's role in the company                                        |
| entity.persons\[].role.id                   | number          | Role identifier                                                     |
| entity.persons\[].role.name                 | string          | Role name (e.g., "Agent", "Director")                               |
| entity.persons\[].role.providerId           | string \| null  | Role provider identifier                                            |
| entity.persons\[].role.isInactive           | boolean \| null | Whether the role is currently inactive                              |
| entity.persons\[].naturesOfControl          | array           | Nature of control entries for this person                           |
| entity.persons\[].personShares              | array           | Share ownership details for this person                             |
| entity.companyContacts                      | object          | Company contact information                                         |
| entity.companyContacts.email                | array           | List of email addresses (partially masked)                          |
| entity.personsCount                         | number          | Total number of associated persons                                  |
| entity.companyContactsCount                 | number          | Total number of contact entries                                     |
| entity.business                             | string          | Unique identifier (UUID) for the business record                    |
