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

<Note>
  This only works for static lists!
</Note>

<Tip>
  The accuracy of the matching process improves with more detailed information. Providing additional parameters can significantly enhance the precision of the results.
</Tip>

## Request

<Warning>
  At least one parameter is needed per company!
</Warning>

#### Body

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

    <ParamField path="country" type="string" placeholder="BE, NL or FR">
      Country can be either `BE`, `NL` or `FR`
    </ParamField>

    <ParamField path="name" type="string">
      Name of the company
    </ParamField>

    <ParamField path="website" type="string">
      Website of the company
    </ParamField>

    <ParamField path="VAT" type="string">
      VAT of the company
    </ParamField>
  </Expandable>

  <Note>
    You can add up to 100 companies to a list at once.
  </Note>
</ParamField>

<ResponseExample>
  ```json Response - 200 theme={null}
  {
    "success": true,
    "message": "Successfully added 99 companies to the list",
    "failed": [ // Example error
      {
        "parameters": {
          "companyNumber": "123",
        },
        "message": "Company not found"
      }
    ]
  }
  ```
</ResponseExample>