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

# Search Companies

## Request

Provide **exactly one** of `q` (name search) or `vat` (VAT-number search). Supplying neither or both returns a `400`. An empty value counts as absent, so `?q=&vat=BE0400378485` is treated as a VAT search.

Search is free — it does not spend credits.

#### Query

<ParamField query="q" type="string">
  The name of the company you want to query, up to 20 characters. Mutually exclusive with `vat`.
</ParamField>

<ParamField query="vat" type="string">
  The VAT number of the company you want to query, up to 30 characters. Mutually exclusive with `q`. Accepts either a formatted (`0400.378.485`) or bare (`BE0400378485`) value — it is normalized across all supported registry/VAT formats before matching.
</ParamField>

<ParamField query="countryCode" type="string" optional>
  Any supported country code — see [Supported countries](/api-reference/v2/supported-countries). If omitted, the search runs across all supported countries.
</ParamField>

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

<ParamField query="offset" type="number" default="0">
  Number of items to skip. (max 9500)
</ParamField>

<ResponseExample>
  ```json Response - 200 theme={null}
  {
      "data": [
          {
              "countryCode": "BE",
              "companyId": "1778186251",
              "name": "Bizzy AI"
          }
      ],
      "pagination": {
          "limit": 4,
          "offset": 0,
          "total": 1
      }
  }
  ```
</ResponseExample>