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

# Companies

## Request

#### Query

<ParamField query="type" type="string" default="ALL">
  Smart list type to fetch - type can be either `SAVED`, `ARCHIVED`, `NEW` or `ALL` which will return every company.
</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
</ParamField>

## Response

<ResponseField name="matchedSince" type="string">
  The matchedSince is in ISO 8601 date format.

  * For **static lists**, this represents the date when the item was added to the list.
  * For **smart lists**, this represents the date the item matched the list's filters and was added as a new result.
</ResponseField>

<ResponseExample>
  ```json Response - 200 theme={null}
  {
      "data": [
          {
              "identifier": {
                  "country": "BE",
                  "companyNumber": "441571714",
                  "name": "TOYOTA MOTOR EUROPE",
                  "place": "Evere"
              },
              "matchedSince": "2024-11-20T13:47:43.000Z"
          },
          {
              "identifier": {
                  "country": "BE",
                  "companyNumber": "403834160",
                  "name": "Janssen Pharmaceutica",
                  "place": "Beerse"
              },
              "matchedSince": "2024-11-20T13:47:43.000Z"
          },
          {
              "identifier": {
                  "country": "BE",
                  "companyNumber": "403170701",
                  "name": "ELECTRABEL",
                  "place": "Bruxelles"
              },
              "matchedSince": "2024-11-20T13:47:43.000Z"
          },
          {
              "identifier": {
                  "country": "BE",
                  "companyNumber": "416375270",
                  "name": "EXXONMOBIL PETROLEUM & CHEMICAL",
                  "place": "Antwerpen"
              },
              "matchedSince": "2024-11-20T13:47:43.000Z"
          }
      ],
      "pagination": {
          "limit": 4,
          "offset": 0,
          "total": 50
      }
  }
  ```
</ResponseExample>