Skip to main content
POST
https://api.bizzy.ai
/
v1
/
companies
/
contacts
/
details
Contact Details
curl --request POST \
  --url https://api.bizzy.ai/v1/companies/contacts/details \
  --header 'Authorization: Bearer <token>'
[
  {
    "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": "[email protected]", // Example 
            "status": "VALID"
          },
          "mobilePhone": {
            "value": "+32 000 00 00 00", // 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

Accept-Language
string
default:"EN"
  • NL: Dutch - FR: French - EN: English

Body

companyContacts
array
You can request up to 100 companies at once.
enrichEmail
boolean
default:"false"
Option to enrich the contact with email address. (If available)
Enriching costs credits - see the Credit usage section
enrichMobilePhone
boolean
default:"false"
Option to enrich the contact with mobile phone number. (If available)
Enriching costs credits - see the Credit usage section

Response

department
string[]
The available departments of the contact.
department is an array of the following values:
  • 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:
  • C_LEVEL
  • FOUNDER
  • OWNER
  • OFFICIAL_DIRECTOR
  • PARTNER
  • VP
  • DIRECTOR
  • SENIOR
  • MANAGER
  • ENTRY
  • INTERN
  • NON_MANAGEMENT
mobilePhone
object
[
  {
    "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": "[email protected]", // Example 
            "status": "VALID"
          },
          "mobilePhone": {
            "value": "+32 000 00 00 00", // 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"
  },
]