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

# Bulk Relationships

## Request

#### Header

<ParamField header="Accept-Language" type="string" default="EN">
  * NL: Dutch - FR: French - EN: English
</ParamField>

#### Body

<ParamField path="companies" type="array">
  <Expandable title="company properties">
    <ResponseField name="companyNumber" type="string" required>
      * Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
      * The Netherlands: KVK number.
      * France: SIREN number.
    </ResponseField>

    <ResponseField name="countryCode" type="string" required>
      countryCode can be either `BE`, `NL` or `FR`
    </ResponseField>
  </Expandable>

  <Note>
    You can request up to 100 companies at once.
  </Note>
</ParamField>

<ResponseExample>
  ```json Response - 200 theme={null}
  [
    {
      "identifier": {
        "country": "BE",
        "companyNumber": "770493071",
        "name": "Bizzy Fintech",
        "place": "Gent"
      },
      "data": {
        "parents": [
          {
            "identifier": {
              "country": "BE",
              "companyNumber": "770493071",
              "name": "Bizzy Fintech",
              "place": "Gent"
            },
            "function": "SHAREHOLDER",
            "percentage": 0.15,
            "name": "Bizzy Fintech"
          },
          {
            "identifier": {
              "country": "BE",
              "companyNumber": "770493071",
              "name": "Bizzy Fintech",
              "place": "Gent"
            },
            "function": "SHAREHOLDER",
            "percentage": 0.012,
            "name": "Bizzy Fintech"
          },
          {
            "identifier": {
              "country": "BE",
              "companyNumber": "770493071",
              "name": "Bizzy Fintech",
              "place": "Gent"
            },
            "function": "SHAREHOLDER",
            "percentage": 0.1171,
            "name": "Bizzy Fintech"
          },
          {
            "identifier": {
              "country": "BE",
              "companyNumber": "770493071",
              "name": "Bizzy Fintech",
              "place": "Gent"
            },
            "function": "SHAREHOLDER",
            "percentage": 0.0157,
            "name": "Bizzy Fintech"
          },
          {
            "identifier": null
          }
        ],
        "children": []
      },
      "message": null
    },
    {
      "identifier": { // Example error
        "country": "BE",
        "companyNumber": "123"
      },
      "data": null,
      "message": "Company not found"
    }
  ]
  ```
</ResponseExample>