GET
/
v1
/
companies
/
{countryCode}
/
{companyNumber}
/
contacts
curl --request GET \
  --url https://api.bizzy.org/v1/companies/{countryCode}/{companyNumber}/contacts \
  --header 'Authorization: Bearer <token>'
{
    "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

​
countryCode
string
required

countryCode can be either BE, NL or FR

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

​
Query

​
q
string

You can query on name or jobTitle.

​
onlyOfficialRoles
boolean
default:"false"

Return only contacts with official roles.

​
limit
number
default:"4"

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

​
offset
number
default:"0"

Number of items to skip.

​
seniorities
string
You can chain multiple seniorities.
For example, use C_LEVEL,NON_MANAGEMENT to search for both C-Level and Non-Management roles.
​
departments
string
You can chain multiple departments.
For example, use SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT to search for both Software-engineering and Product-Management departments.
​
officialRoles
string
You can chain multiple official roles.
For example, use FOUNDER,COOWNER to search for both Founder and Co-owner official roles.

​
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
    }
}