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

# Contacts

## Request

#### Path

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

<ParamField path="companyId" type="string" required>
  Obfuscated companyId returned by the search endpoint.
</ParamField>

#### Query

<ParamField path="q" type="string">
  You can query on name or jobTitle.
</ParamField>

<ParamField path="onlyOfficialRoles" type="boolean" default="false">
  Return only contacts with official roles.
</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>

<ParamField path="seniorities" type="string">
  <Tip>
    You can chain multiple seniorities.

    <br />

    For example, use `C_LEVEL,NON_MANAGEMENT` to search for both C-Level and
    Non-Management roles.
  </Tip>

  <Accordion title="Available Seniorities">
    * `C_LEVEL`
    * `FOUNDER`
    * `OWNER`
    * `OFFICIAL_DIRECTOR`
    * `PARTNER`
    * `VP`
    * `DIRECTOR`
    * `SENIOR`
    * `MANAGER`
    * `ENTRY`
    * `INTERN`
    * `NON_MANAGEMENT`
  </Accordion>
</ParamField>

<ParamField query="departments" type="string">
  <Tip>
    You can chain multiple departments.

    <br />

    For example, use `SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT` to search for
    both Software-engineering and Product-Management departments.
  </Tip>

  <Accordion title="Available Departments">
    * `C_SUITE`,
    * `ENGINEERING_AND_IT`,
    * `DESIGN`,
    * `EDUCATION`,
    * `FINANCE`,
    * `HUMAN_RESOURCES`,
    * `LEGAL`,
    * `MARKETING`,
    * `MEDICAL_HEALTH`,
    * `OPERATIONS`,
    * `CONSULTING`,
    * `SALES`,
    * `BOARD_OF_DIRECTORS`,
    * `RESEARCH_AND_DEVELOPMENT`,
    * `AGRICULTURE`,
    * `MANUFACTURING`,
    * `CONSTRUCTION`,
    * `HOSPITALITY`,
    * `MEDICAL_AND_HEALTH`,
  </Accordion>
</ParamField>

<ParamField query="officialRoles" type="string">
  <Tip>
    You can chain multiple official roles.

    <br />

    For example, use `FOUNDER,COOWNER` to search for both Founder and Co-owner
    official roles.
  </Tip>

  <Accordion title="Available Official Roles">
    * `ACTING_BAILIFF`
    * `ADMINISTRATOR`
    * `ASSOCIATE`
    * `AUDITOR`
    * `BOARD_MEMBER`
    * `CHAIRMAN`
    * `CHAIRMAN_OF_STATUTORY_AUDITORS`
    * `CHARTERED_ACCOUNTANT`
    * `CURATOR`
    * `DEPUTY_MANAGING_DIRECTOR`
    * `DEPUTY_PERMANENT_REPRESENTATIVE`
    * `EXTERNAL_ACCOUNTANT`
    * `FOUNDER`
    * `GENERAL_ADMINISTRATOR`
    * `GENERAL_AGENT`
    * `GOVERNMENT_COMMISSIONER`
    * `JUDICIAL_BOARD`
    * `JUDICIAL_TRUSTEE`
    * `LEGAL_REPRESENTATIVE`
    * `MANAGER`
    * `MANAGING_DIRECTOR`
    * `MAYOR`
    * `MEMBER_OF_AREA_ASSOCIATION`
    * `PERMANENT_REPRESENTATIVE`
    * `AUDITOR_PERMANENT_REPRESENTATIVE`
    * `PERSON_IN_CHARGE`
    * `PROPERTY_MANAGER`
    * `REGISTERED_AUDITOR`
    * `REGISTERED_TAX_EXPERT`
    * `REPRESENTATIVE`
    * `REPRESENTATIVE_NON_ADMIN`
    * `SEQUESTER`
    * `SUPPLY_SOLICITOR`
    * `TREASURER`
    * `TRUSTEE`
    * `VICE_PRESIDENT`
    * `SHAREHOLDER`
    * `OTHER`
    * `CIC_MANAGER`
    * `LLP_MEMBER`
    * `MANAGER_OF_AN_EEIG`
    * `MEMBER_OF_A_MANAGEMENT_ORGAN`
    * `MEMBER_OF_A_SUPERVISORY_ORGAN`
    * `MEMBER_OF_AN_ADMINISTRATIVE_ORGAN`
    * `NOMINEE_DIRECTOR`
    * `NOMINEE_SECRETARY`
    * `SECRETARY`
    * `DIRECTOR`
    * `GENERAL_PARTNER_IN_A_LIMITED_PARTNERSHIP`
    * `JUDICIAL_FACTOR`
    * `LIMITED_PARTNER_IN_A_LIMITED_PARTNERSHIP`
    * `LLP_DESIGNATED_MEMBER`
    * `PERSON_AUTHORISED_TO_ACCEPT`
    * `PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT`
    * `RECEIVER_AND_MANAGER`
    * `ABSOLUTE_PARENT`
    * `MEMBER`
    * `MANAGEMENT_CONTROLLER`
    * `ACCOUNT_CONTROLLER`
    * `OTHER_MAJORITY_PARTNER`
    * `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_MANAGER_PARTNER`
    * `JOINT_INDEFINITELY_LIABLE_MANAGER_PARTNER`
    * `LIQUIDATOR`
    * `SOLE_PARTNER_ACTIVE_IN_EURL`
    * `PRESIDENT_OF_BOARD_OF_DIRECTORS`
    * `PRESIDENT_OF_EXECUTIVE_BOARD`
    * `GENERAL_DIRECTOR`
    * `FOREIGN_ENTITY_FOREIGN_EXECUTIVE`
    * `FOREIGN_ENTITY_FRENCH_EXECUTIVE`
    * `PRESIDENT_AND_GENERAL_DIRECTOR_OF_BOARD`
    * `PRESIDENT_OF_SUPERVISORY_BOARD`
    * `EXECUTIVE_BOARD_MEMBER`
    * `SUPERVISORY_BOARD_MEMBER`
    * `PERSON_AUTHORIZED_TO_REPRESENT_COMPANY`
    * `PERSON_AUTHORIZED_TO_REPRESENT_ESTABLISHMENT`
    * `CHIEF_EXECUTIVE_OFFICER`
    * `DEPUTY_GENERAL_DIRECTOR`
    * `STATUTORY_AUDITOR`
    * `ALTERNATE_AUDITOR`
    * `PRESIDENT_OF_SAS`
    * `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_PARTNER`
    * `JOINT_INDEFINITELY_LIABLE_PARTNER`
    * `FOREIGN_COMPANY_FRENCH_SOCIAL_REPRESENTATIVE`
    * `FOREIGN_COMPANY_FRENCH_FISCAL_REPRESENTATIVE`
    * `COOWNER`
    * `OPERATOR_FOR_COOWNERSHIP`
    * `PHYSICAL_PERSON_OPERATING_TOGETHER`
    * `SPECIAL_AGENT`
    * `TEMPORARY_ADMINISTRATOR`
    * `UNSALARIED_MEMBER_PARTICIPATING_IN_WORK`
    * `PARTNER_INVOLVED_IN_MANAGEMENT`
    * `UNSALARIED_PARTNER`
    * `ACQUIRER`
    * `ENTREPRENEUR`
    * `DEPUTY`
    * `DESIGNATED_DECISION_MAKER`
    * `ACCOUNTANT`
    * `COOWNER_HEIR`
    * `LESSOR`
    * `BENIFICIAL_OWNER`
    * `TAX_AGENT`
    * `VICE_PRESIDENT_MANAGEMENT`
    * `VICE_PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
    * `PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
    * `MEMBER_ORIENTATION_AND_SURVEILLANCE`
    * `SOLE_PARTNER_ASSET_RECOVERY`
    * `GENERAL_PARTNER`
    * `PRESIDENT_OF_EPIC`
    * `LAWYER`
    * `TAX_REPRESENTATIVE`
    * `BENFICIAL_MEMBER`
    * `PERSON_AUTHORIZED_TO_REPRESENT_ENTITY`
    * `PRESIDENT`
    * `GENERAL_SECRETARY`
    * `UNION_BOARD_MEMBER`
    * `UNION_BOARD_PRESIDENT`
    * `PERSON_DESIGNATED_BY_BYLAWS`
  </Accordion>
</ParamField>

## Response

<Warning>
  **Warning:** While it is possible for `contactId` values to change, this will not happen often and should not occur regularly.<br /><br /> However, it is important not to rely solely on `contactId` values in your workflows, as they could fluctuate in the future.<br /><br /> For more consistent results, consider using other identifiers or attributes when working with contacts.
</Warning>

<ResponseExample>
  ```json Response - 200 theme={null}
  {
      "identifier": {
          "countryCode": "BE",
          "companyId": "1778186251",
          "name": "Bizzy ",
      },
      "data": [
          {
              "identifier": {
                  "contactId": "1740201639",
                  "firstName": "Steve",
                  "lastName": "Declercq"
              }
          },
          {
              "identifier": {
                  "contactId": "1280731968",
                  "firstName": "Hendrik",
                  "lastName": "Keeris"
              }
          },
          {
              "identifier": {
                  "contactId": "1858956880",
                  "firstName": "David",
                  "lastName": "Du Pré"
              }
          },
          {
              "identifier": {
                  "contactId": "1122224600",
                  "firstName": "Piet",
                  "lastName": "Casneuf"
              }
          }
      ],
      "pagination": {
          "limit": 4,
          "offset": 0,
          "total": 39
      }
  }
  ```
</ResponseExample>