Contact Details

POST /v1/companies/contacts/details

Contact Details

cURL

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

Response - 200

[
  {
    "companyIdentifier": {
      "country": "BE",
      "companyNumber": "770493071",
      "name": "Bizzy Fintech",
      "place": "Gent"
    },
    "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": "[e-mail]", // Example 
            "status": "VALID"
          },
          "mobilePhone": {
            "value": "[phone]", // Example
            "dataProvider": "PROSPEO",
            "error": null
          }
        },
        "message": null
      },
      {
        "contactIdentifier": {
          "contactId": 123, // Example error contact
        },
        "data": null,
        "message": "Contact not found"
      }
    ],
    "message": null
  },
  {
    "companyIdentifier": { // Example error company
      "country": "BE",
      "companyNumber": "123"
    },
    "contacts": null,
    "message": "Company not found"
  },
]

Request

Header

Accept-Language · string · default: "EN"

• NL: Dutch - FR: French - EN: English

Body

companyContacts · array

Show companyContact properties

company · object · required

Show company properties

companyNumber · string · required

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

countryCode · string · required

countryCode can be either BE, NL or FR

contacts · array · required

Show contact properties

contactId · 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.

enrichEmail · boolean · default: "false"

Option to enrich the contact with email address. (If available)

enrichMobilePhone · boolean · default: "false"

Option to enrich the contact with mobile phone number. (If available)

Response

department · 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

seniority · 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

mobilePhone · object

Show mobilePhone properties

value · string

Mobile phone in the following format: [phone]

dataProvider · string

The data provider of the mobile phone number.

• PROSPEO
• CLEON1
• FORAGER

error · string

Possible errors when enriching the mobile phone number.

• RATE_LIMITED
• RATE_LIMITED_BURST
• INTERNAL_ERROR
• INVALID_INPUT

Response - 200

[
  {
    "companyIdentifier": {
      "country": "BE",
      "companyNumber": "770493071",
      "name": "Bizzy Fintech",
      "place": "Gent"
    },
    "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": "[e-mail]", // Example 
            "status": "VALID"
          },
          "mobilePhone": {
            "value": "[phone]", // Example
            "dataProvider": "PROSPEO",
            "error": null
          }
        },
        "message": null
      },
      {
        "contactIdentifier": {
          "contactId": 123, // Example error contact
        },
        "data": null,
        "message": "Contact not found"
      }
    ],
    "message": null
  },
  {
    "companyIdentifier": { // Example error company
      "country": "BE",
      "companyNumber": "123"
    },
    "contacts": null,
    "message": "Company not found"
  },
]