Contacts

Contacts

curl --request GET \
  --url https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "identifier": {
        "country": "BE",
        "companyNumber": "770493071",
        "name": "Bizzy Fintech",
        "place": "Gent"
    },
    "data": [
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1740201639,
                "firstName": "Steve",
                "lastName": "Declercq"
            }
        },
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1280731968,
                "firstName": "Hendrik",
                "lastName": "Keeris"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1858956880,
                "firstName": "David",
                "lastName": "Du Pré"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1122224600,
                "firstName": "Piet",
                "lastName": "Casneuf"
            }
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 39
    }
}

GET

companies

{countryCode}

{companyNumber}

contacts

Contacts

curl --request GET \
  --url https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber}/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "identifier": {
        "country": "BE",
        "companyNumber": "770493071",
        "name": "Bizzy Fintech",
        "place": "Gent"
    },
    "data": [
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1740201639,
                "firstName": "Steve",
                "lastName": "Declercq"
            }
        },
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1280731968,
                "firstName": "Hendrik",
                "lastName": "Keeris"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1858956880,
                "firstName": "David",
                "lastName": "Du Pré"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1122224600,
                "firstName": "Piet",
                "lastName": "Casneuf"
            }
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 39
    }
}

Request

Path

string

required

countryCode can be either BE, NL or FR

string

required

Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
The Netherlands: KVK number
France: SIREN number

Query

string

You can query on name or jobTitle.

boolean

default:"false"

Return only contacts with official roles.

number

default:"4"

Number of items to return per page. (max 500)

number

default:"0"

Number of items to skip.

string

You can chain multiple seniorities.
For example, use C_LEVEL,NON_MANAGEMENT to search for both C-Level and Non-Management roles.

Available Seniorities

C_LEVEL
FOUNDER
OWNER
OFFICIAL_DIRECTOR
PARTNER
VP
DIRECTOR
SENIOR
MANAGER
ENTRY
INTERN
NON_MANAGEMENT

string

You can chain multiple departments.
For example, use SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT to search for both Software-engineering and Product-Management departments.

Available Departments

SOFTWARE_ENGINEERING
DATA_ANALYTICS
CLOUD_ENGINEERING
BIO_ENGINEERING
CHEMICAL_ENGINEERING
ENGINEERING
PROJECT_MANAGEMENT
PRODUCT_MANAGEMENT
TEST_AND_QUALITY_ASSURANCE
CYBER_SECURITY
INNOVATION_AND_DIGITAL_TRANSFORMATION
FINANCE
ACCOUNTING
INVESTOR_RELATIONS
REAL_ESTATE_FINANCE
FINANCIAL_RISK
ASSET_MANAGEMENT
SOURCING_AND_PROCUREMENT
TAX
TREASURY
BANKING
PAYROLL_COMPENSATION_AND_BENEFITS
DIVERSITY_EQUITY_INCLUSION
RECRUITMENT
LEARNING_AND_DEVELOPMENT
HUMAN_RESOURCES
COMPLIANCE
PRIVACY
INTELLECTUAL_PROPERTY
LEGAL
DIGITAL_MARKETING
BRAND_MANAGEMENT
CONTENT_MARKETING
LEAD_GENERATION
PUBLIC_RELATIONS
SEO_OPTIMIZTION
EVENTS
SPONSORSHIPS
MARKETING
CORPORATE_STRATEGY
CUSTOMER_SUPPORT
LOGISTICS
SUPPLY_CHAIN
FACILITY_AND_PROPERTY_MANAGEMENT
OFFICE_MANAGEMENT
SAFETY_AND_SECURITY
STORE_OPERATIONS
OPERATIONS
ADMINISTRATION
ACCOUNT_MANAGEMENT
BUSINESS_DEVELOPMENT
CHANNEL_SALES
CUSTOMER_SUCCESS
PARTNERSHIPS
SALES

string

You can chain multiple official roles.
For example, use FOUNDER,COOWNER to search for both Founder and Co-owner official roles.

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

Response

Warning: While it is possible for contactId values to change, this will not happen often and should not occur regularly.

However, it is important not to rely solely on contactId values in your workflows, as they could fluctuate in the future.

For more consistent results, consider using other identifiers or attributes when working with contacts.

{
    "identifier": {
        "country": "BE",
        "companyNumber": "770493071",
        "name": "Bizzy Fintech",
        "place": "Gent"
    },
    "data": [
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1740201639,
                "firstName": "Steve",
                "lastName": "Declercq"
            }
        },
        {
            "jobTitle": "Co-Founder",
            "identifier": {
                "contactId": 1280731968,
                "firstName": "Hendrik",
                "lastName": "Keeris"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1858956880,
                "firstName": "David",
                "lastName": "Du Pré"
            }
        },
        {
            "jobTitle": "Board Member",
            "identifier": {
                "contactId": 1122224600,
                "firstName": "Piet",
                "lastName": "Casneuf"
            }
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 39
    }
}

Getting Started

V2 API

V1 API

Request

Path

Query

Response

​Request

​Path

​Query

​Response

Request

Path

Query

Response