Contact Details

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

import requests

url = "https://api.bizzy.ai/v2/companies/{companyId}/contacts/{contactId}"

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/v2/companies/{companyId}/contacts/{contactId}', 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/{companyId}/contacts/{contactId}",
  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/v2/companies/{companyId}/contacts/{contactId}"

	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/v2/companies/{companyId}/contacts/{contactId}")

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

{
    "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
        }
    }
}

GET

companies

{companyId}

contacts

{contactId}

Contact Details

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

import requests

url = "https://api.bizzy.ai/v2/companies/{companyId}/contacts/{contactId}"

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/v2/companies/{companyId}/contacts/{contactId}', 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/{companyId}/contacts/{contactId}",
  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/v2/companies/{companyId}/contacts/{contactId}"

	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/v2/companies/{companyId}/contacts/{contactId}")

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

{
    "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
        }
    }
}

Request

Path

string

required

Obfuscated companyId returned by the search endpoint.

string

required

ContactId is the unique identifier of the contact.

Response

This endpoint no longer enriches email or mobilePhone inline — both are always returned unenriched (value: null, status/error: null). To enrich a contact, use Enrich Contact and poll Enrichment Status for the 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

{
    "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
        }
    }
}

Getting Started

V2 API

V1 API

Contact Details

Request

Path

Response

​Request

​Path

​Response

Request

Path

Response