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

## 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="companyId" type="string" required>
      Obfuscated companyId returned by the search endpoint.
    </ResponseField>

    <ResponseField name="countryCode" type="string" required>
      Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
    </ResponseField>
  </Expandable>

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

<ParamField body="limit" type="number" default="4">
  Number of items to return per page. (max 500)
</ParamField>

<ParamField body="offset" type="number" default="0">
  Number of items to skip. `companies.length x limit` may not exceed 500.
</ParamField>

## Response

<Note>
  The same limit and offset are shared over all companies.
</Note>

<ResponseExample>
  ```json Response - 200 theme={null}
  [
      {
          "identifier": {
              "countryCode": "BE",
              "companyId": "1778186251",
              "name": "Bizzy"
          },
          "data": {
              "updates": [
                  {
                      "id": "2127510865",
                      "type": "EXPANSION",
                      "title": "Business intelligence platform Bizzy plans first steps abroad"
                  }
              ]
          },
          "pagination": {
              "limit": 4,
              "offset": 0,
              "total": 1
          },
          "message": null
      },
      { // Example error
          "identifier": {
              "countryCode": "BE",
              "companyId": "123",
              "name": ""
          },
          "data": null,
          "pagination": null,
          "message": "Company not found"
      },
  ]
  ```
</ResponseExample>
