Bulk Contact Details

curl --request POST \
  --url https://api.bizzy.ai/v2/companies/contacts/details \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.bizzy.ai/v2/companies/contacts/details', 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/v2/companies/contacts/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/v2/companies/contacts/details"

	req, _ := http.NewRequest("POST", 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/v2/companies/contacts/details")

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

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

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

[
  {
    "companyIdentifier": {
      "countryCode": "BE",
      "companyId": "770493071",
      "name": "Bizzy",
    },
    "contacts": [
      {
        "contactIdentifier": {
          "contactId": "1234567890",
          "firstName": "John",
          "lastName": "Doe"
        },
        "data": {
          "firstName": "John",
          "lastName": "Doe",
          "fullName": "John Doe",
          "linkedinUrl": "https://be.linkedin.com/in/john-doe",
          "jobTitle": "Software Engineer",
          "department": [
            "ENGINEERING"
          ],
          "seniority": [
            "NON_MANAGEMENT"
          ],
          "email": {
            "value": null,
            "status": null
          },
          "mobilePhone": {
            "value": null,
            "dataProvider": null,
            "error": null
          }
        },
        "message": null
      },
      {
        "contactIdentifier": {
          "contactId": "123", // Example error contact
        },
        "data": null,
        "message": "Contact not found"
      }
    ],
    "message": null
  },
  {
    "companyIdentifier": { // Example error company
      "countryCode": "BE",
      "companyId": "123",
      "name": ""
    },
    "contacts": null,
    "message": "Company not found"
  },
]

POST

companies

contacts

details

Bulk Contact Details

curl --request POST \
  --url https://api.bizzy.ai/v2/companies/contacts/details \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.bizzy.ai/v2/companies/contacts/details', 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/v2/companies/contacts/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/v2/companies/contacts/details"

	req, _ := http.NewRequest("POST", 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/v2/companies/contacts/details")

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

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

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

[
  {
    "companyIdentifier": {
      "countryCode": "BE",
      "companyId": "770493071",
      "name": "Bizzy",
    },
    "contacts": [
      {
        "contactIdentifier": {
          "contactId": "1234567890",
          "firstName": "John",
          "lastName": "Doe"
        },
        "data": {
          "firstName": "John",
          "lastName": "Doe",
          "fullName": "John Doe",
          "linkedinUrl": "https://be.linkedin.com/in/john-doe",
          "jobTitle": "Software Engineer",
          "department": [
            "ENGINEERING"
          ],
          "seniority": [
            "NON_MANAGEMENT"
          ],
          "email": {
            "value": null,
            "status": null
          },
          "mobilePhone": {
            "value": null,
            "dataProvider": null,
            "error": null
          }
        },
        "message": null
      },
      {
        "contactIdentifier": {
          "contactId": "123", // Example error contact
        },
        "data": null,
        "message": "Contact not found"
      }
    ],
    "message": null
  },
  {
    "companyIdentifier": { // Example error company
      "countryCode": "BE",
      "companyId": "123",
      "name": ""
    },
    "contacts": null,
    "message": "Company not found"
  },
]

Request

string

default:"EN"

NL: Dutch - FR: French - EN: English

Body

array

Show companyContact properties

object

required

Show companyIdentifier properties

string

required

Obfuscated companyId returned by the search endpoint.

string

required

Any supported country code — see Supported countries.

array

required

Show contact properties

string

required

contactId is the unique identifier you get from the contacts endpoint.

You can request up to 50 contacts per company at once.

You can request up to 100 companies at once.

Response

This endpoint no longer enriches email or mobilePhone inline — both are always returned unenriched (value: null, status/error: null). To enrich contacts in bulk, use Bulk Enrich Contacts and poll Enrichment Status for each result.

string[]

The available departments of the contact.
department is an array of the following values:

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[]

The available seniorities of the contact.
seniority is an array of the following values:

Available Seniorities

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

object

Show email properties

string

The contact’s email address, or null when not available.

string

Status of the returned email address. One of:

VALID
CATCHALL
NOT_FOUND
null (when the email has not been enriched)

object

Show mobilePhone properties

string

Mobile phone in the following format: +32 000 00 00 00

string

The data provider of the mobile phone number.

PROSPEO
CLEON1
FORAGER

string

Possible errors when enriching the mobile phone number.

INVALID_API_KEY
INSUFFICIENT_CREDITS
RATE_LIMITED
RATE_LIMITED_BURST
INTERNAL_ERROR
INVALID_INPUT
BILLING
FORBIDDEN
TIMEOUT

[
  {
    "companyIdentifier": {
      "countryCode": "BE",
      "companyId": "770493071",
      "name": "Bizzy",
    },
    "contacts": [
      {
        "contactIdentifier": {
          "contactId": "1234567890",
          "firstName": "John",
          "lastName": "Doe"
        },
        "data": {
          "firstName": "John",
          "lastName": "Doe",
          "fullName": "John Doe",
          "linkedinUrl": "https://be.linkedin.com/in/john-doe",
          "jobTitle": "Software Engineer",
          "department": [
            "ENGINEERING"
          ],
          "seniority": [
            "NON_MANAGEMENT"
          ],
          "email": {
            "value": null,
            "status": null
          },
          "mobilePhone": {
            "value": null,
            "dataProvider": null,
            "error": null
          }
        },
        "message": null
      },
      {
        "contactIdentifier": {
          "contactId": "123", // Example error contact
        },
        "data": null,
        "message": "Contact not found"
      }
    ],
    "message": null
  },
  {
    "companyIdentifier": { // Example error company
      "countryCode": "BE",
      "companyId": "123",
      "name": ""
    },
    "contacts": null,
    "message": "Company not found"
  },
]

Getting Started

V2 API

V1 API

Bulk Contact Details

Request

Header

Body

Response

​Request

​Header

​Body

​Response

Request

Header

Body

Response