# API Updates
Source: https://docs.bizzy.ai/api-reference/changelog/index
### Additions
* [Added a new company search endpoint](v2/search/companies) at `GET /v2/search/companies` — search by name (`q`) or VAT number (`vat`), with pagination and a `{ data, pagination }` response envelope.
* [Added a new legal entity search endpoint](v2/search/legal-entities) at `GET /v2/search/legal-entities` — same name/VAT search, pagination, and envelope.
### Deprecations
* [`GET /v2/companies` search is deprecated](v2/company/search) in favour of [`GET /v2/search/companies`](v2/search/companies). It remains available for backwards compatibility (name-only, bare array, no pagination) and now returns a `Deprecation` response header.
### Announcements
* **API v2 is now stable** — the Beta tag has been removed. v2 is the recommended and actively developed version going forward.
* **API v1 is now deprecated** and will no longer be supported after **15 November 2026**. v1 documentation stays online and marked as deprecated until then. See the [v2 documentation](../v2/company/introduction) to migrate.
### Breaking Changes
* [Removed inline `enrichEmail`/`enrichMobilePhone` enrichment from the Contact Details endpoints](v2/company/contactDetails) — `email` and `mobilePhone` are now always returned unenriched.
* Renamed the `id` field to `enrichmentId` on the [Enrichment Status](v2/enrichments/status) response, for consistency with the enrichment-creation endpoints.
### Additions
* Enrichments:
* [Added a new endpoint to enrich a single contact's email/mobile phone asynchronously](v2/company/contactEnrich)
* [Added a new endpoint to enrich contacts in bulk asynchronously](v2/company/contactEnrichBulk) — returns `202 Accepted`
* [Added a new endpoint to poll enrichment status](v2/enrichments/status)
### Modifications
* [Added `jobTitle` to the company contacts list response](v2/company/contacts)
* [Legal entity document `url` values are normalized to a full URL](v2/legalEntity/documents), with NBB-sourced documents returned as a signed URL; documents are never omitted from the response.
* Synchronous [contact enrichment](v2/company/contactEnrich) charges now report `X-Bizzy-Credits-Balance`/`X-Bizzy-Credits-Charged` response headers, consistent with the rest of the charged API surface.
### Breaking Changes
* [Dropped the `countryCode` path segment from single-entity company and legal entity GET endpoints](v2/company/introduction) — country is now always resolved from the entity itself, with no deprecation alias.
* [Simplified the company vacancies response to core job fields](v2/company/vacancies) — removed `id`, `companyId`, `locationKey`, `isActive`, `source`, `createdAt`, and `updatedAt`.
* [Removed the unused `id` field from company technologies](v2/company/technologies)
* [Removed the raw relevance `score` field from company lookalikes](v2/company/lookalikes)
* Renamed generic `identifier` object keys to entity-specific names (`companyIdentifier`, `contactIdentifier`, `legalEntityIdentifier`, `listIdentifier`, `savedSearchIdentifier`) across all V2 endpoints.
### Modifications
* [`website` now returns a full URL instead of a bare domain](v2/company/details) on company and legal entity details endpoints.
### Additions
* Lists:
* [Added a new endpoint to fetch lists](v2/lists/overview)
* [Added a new endpoint to fetch a single list](v2/lists/details)
* [Added a new endpoint to fetch the items of a list](v2/lists/results)
* [Added a new endpoint to add items to a list](v2/lists/add-items)
* [Added a new endpoint to queue a list export](v2/lists/export)
* Saved Searches:
* [Added a new endpoint to fetch saved searches](v2/saved-searches/overview)
* [Added a new endpoint to fetch a single saved search](v2/saved-searches/details)
* [Added a new endpoint to execute a saved search and fetch its results](v2/saved-searches/results)
* Exports:
* [Added a new endpoint to fetch the status of an export](v2/exports/status)
* Agents:
* [Added a new endpoint to fetch agents](v2/agents/overview)
### Modifications
* [Expanded the list of supported countries for the V2 API to 33 countries](../v2/supported-countries)
* Corrected the response documentation across the V2 Company and Legal Entity endpoints
(identifier `countryCode` field, request body vs. query parameters, and pagination caps).
### Additions
* Company:
* [Added a new endpoint to fetch company updates](v2/company/updates)
* [Added a new endpoint to fetch company updates in bulk](v2/company/updatesBulk)
* Legal Entity
* [Added a new endpoint to fetch legal entity updates](v2/legalEntity/updates)
* [Added a new endpoint to fetch legal entity updates in bulk](v2/legalEntity/updatesBulk)
### Additions
* Company:
* [Added a new endpoint to fetch company contacts](v2/company/contacts)
* [Added a new endpoint to fetch company contacts in bulk](v2/company/contactsBulk)
* [Added a new endpoint to fetch company contact details](v2/company/contactDetails)
* [Added a new endpoint to fetch company contact details in bulk](v2/company/contactDetailsBulk)
* [Added a new endpoint to fetch company lookalikes](v2/company/lookalikes)
* [Added a new endpoint to fetch company lookalikes in bulk](v2/company/lookalikesBulk)
* [Added a new endpoint to fetch company technologies](v2/company/technologies)
* [Added a new endpoint to fetch company technologies in bulk](v2/company/technologiesBulk)
* [Added a new endpoint to fetch company vacancies](v2/company/vacancies)
* [Added a new endpoint to fetch company vacancies in bulk](v2/company/vacanciesBulk)
* [Added a new endpoint to fetch company legal entities](v2/company/legalEntities)
* Legal Entity
* [Added a new endpoint to fetch legal entity details](v2/legalEntity/details)
* [Added a new endpoint to fetch legal entity details in bulk](v2/legalEntity/detailsBulk)
* [Added a new endpoint to fetch legal entity financials](v2/legalEntity/financials)
* [Added a new endpoint to fetch legal entity financials in bulk](v2/legalEntity/financialsBulk)
* [Added a new endpoint to fetch legal entity directors](v2/legalEntity/directors)
* [Added a new endpoint to fetch legal entity directors in bulk](v2/legalEntity/directorsBulk)
* [Added a new endpoint to fetch legal entity ownership](v2/legalEntity/ownership)
* [Added a new endpoint to fetch legal entity ownership in bulk](v2/legalEntity/ownershipBulk)
* [Added a new endpoint to fetch legal entity establishments](v2/legalEntity/establishments)
* [Added a new endpoint to fetch legal entity establishments in bulk](v2/legalEntity/establishmentsBulk)
* [Added a new endpoint to fetch legal entity documents](v2/legalEntity/documents)
* [Added a new endpoint to fetch legal entity documents in bulk](v2/legalEntity/documentsBulk)
### Additions
* Company:
* [Added a new endpoint to search for companies](v2/company/search)
* [Added a new endpoint to fetch company details](v2/company/details)
* [Added a new endpoint to fetch company details in bulk](v2/company/detailsBulk)
### Modifications
* Restructured documentation to distinguish between v1 and v2.
### Additions
* Company:
* [Added a new endpoint to fetch company details in bulk](v1/company/detailsBulk)
* [Added a new endpoint to fetch company financials in bulk](v1/company/financialsBulk)
* [Added a new endpoint to fetch company relationships in bulk](v1/company/relationshipsBulk)
* [Added a new endpoint to fetch company lookalikes in bulk](v1/company/lookalikesBulk)
* [Added a new endpoint to fetch company contacts in bulk](v1/company/contactsBulk)
* [Added a new endpoint to fetch company contact details in bulk](v1/company/contactDetailsBulk)
* Lists:
* [Added a new enpoint to add companies in bulk to a static list](v1/lists/companiesBulk)
* [Added a new enpoint to add contacts in bulk to a static list](v1/lists/contactsBulk)
* [Added a new endpoint to queue an export](v1/lists/export)
* Exports:
* [Added a new endpoint to fetch the details of an export](v1/export/details)
### Modifications
* [Update base URL to https://api.bizzy.ai](../usage/introduction#base-url)
### Additions
* Company:
* [Added a new endpoint to fetch contacts](v1/company/contacts)
* [Added a new endpoint to fetch contact details](v1/company/contactDetails)
* Lists:
* [Added a new endpoint to fetch contacts](v1/lists/contacts)
* [Added a new endpoint to add a contact to a static list](v1/lists/contact)
### Modifications
* Credit usage:
* Updated the credit usage page to explain contact enrichments.
### Additions
* [Errors are now documented](../v1/errors)
### Additions
* Company:
* [Added a new endpoint to search for companies](v1/company/search)
* Lists:
* [Added a new endpoint to add a company to a static list](v1/lists/company)
### Additions
* Lists:
* [Added a new endpoint to fetch lists](v1/lists/overview)
* [Added a new endpoint to fetch a single list](v1/lists/single)
* [Added a new endpoint to fetch companies from a list](v1/lists/companies)
# Getting started
Source: https://docs.bizzy.ai/api-reference/usage/introduction
## Accessing the API
The Bizzy Public API allows you to fetch our data directly in your application. We use a straightforward REST API.
You can obtain your API key by contacting your Bizzy account manager.
## Authentication
All requests must include a bearer token in the Authorization header.
```json theme={null}
{
"Authorization": Bearer YOUR_TOKEN_HERE
}
```
## Base URL
[https://api.bizzy.ai](https://api.bizzy.ai)
## Support
For any questions or issues, please contact our support team at [support@bizzy.ai](mailto:support@bizzy.ai).
# Language
Source: https://docs.bizzy.ai/api-reference/usage/language
All data can be returned in our supported languages:
* Dutch (NL)
* French (FR)
* English (EN)
Set the preferred language by including the `Accept-Language` header in your request.
Example:
```json theme={null}
{
"Accept-Language": "EN"
}
```
# Pagination
Source: https://docs.bizzy.ai/api-reference/usage/pagination
Some endpoints support pagination, which can be accessed via the following query parameters:
* `limit`: Number of items to return per page (default: 4)
* `offset`: Number of items to skip (default: 0)
All paginated items are sorted from newest to oldest.
Example:
```
?limit=4&offset=0
```
# Add Companies to Import Queue
Source: https://docs.bizzy.ai/api-reference/v1/agent/add-companies
POST /v1/agents/import-queue/{sessionId}/companies
Add one or more companies to an existing import queue session. You can call this endpoint multiple times to add companies in batches.
## Request
#### Path Parameters
The session ID returned from the [start import queue](/api-reference/agent/start-import-queue) endpoint
#### Body
Array of company objects to import. Must contain at least 1 and at most 250 companies.
The customer type for this company. Must be one of:
* `CUSTOMER` - Existing customer
* `LEAD` - Potential lead
* `UNKNOWN` - Status unknown
ISO 3166-1 alpha-2 country code (e.g., `BE`, `NL`, `FR`)
The name of the company
The company's website URL
The company's VAT number
## Company Matching
To accurately match companies in Bizzy's database, provide identifying information for each company:
**Preferred identifier:**
* **`vat`** - The VAT number is the most reliable identifier as it's unique per company and allows for a perfect 1-on-1 match
**Alternative identification:**
* If no VAT number is available, provide a combination of:
* `name` - Company name
* `country` - Country code
* `website` - Company website
When using the alternative method, Bizzy performs a combined search using all provided fields and selects the company that best matches the data in our database.
For best results, always include the VAT number when available. When VAT is not available, provide as many identifying fields as possible (name, country, website) to improve matching accuracy.
## Response
```json Request theme={null}
{
"companies": [
{
"customer": "LEAD",
"country": "BE",
"name": "Example Company NV",
"website": "https://example.com",
"vat": "BE0123456789"
},
{
"customer": "CUSTOMER",
"name": "Another Company BV",
"country": "NL"
}
]
}
```
```json Response - 200 theme={null}
{
"success": true,
"added": 2
}
```
```json Response - 400 (Invalid Session State) theme={null}
{
"error": "Session is not in pending state"
}
```
```json Response - 400 (Empty Array) theme={null}
{
"error": "companies must be a non-empty array"
}
```
```json Response - 400 (Array Too Large) theme={null}
{
"error": "companies array cannot exceed 250 items"
}
```
Whether the companies were successfully added to the queue
The number of companies added in this request
## Notes
* The session must be in `PENDING` status to accept companies
* You can call this endpoint multiple times to add companies in batches
* Each request can contain a maximum of 250 companies
* Companies are not processed until you [complete the session](/api-reference/agent/complete-import-queue)
# Complete Import Queue
Source: https://docs.bizzy.ai/api-reference/v1/agent/complete-import-queue
POST /v1/agents/import-queue/{sessionId}/complete
Mark an import queue session as complete and trigger the processing of all companies added to the session. Once completed, no additional companies can be added to this session.
## Request
#### Path Parameters
The session ID of the import queue to complete
## Response
```json Response - 200 theme={null}
{
"success": true
}
```
```json Response - 400 (Invalid Session State) theme={null}
{
"error": "Session is not in pending state"
}
```
```json Response - 404 (Session Not Found) theme={null}
{
"error": "Session not found"
}
```
Whether the session was successfully marked as complete
## Workflow
After completing a session:
1. The session status changes from `PENDING` to `PROCESSING`
2. **All existing companies from previous API imports are removed**
3. Bizzy begins matching and enriching the companies you added
4. Matched companies are imported into your agent
5. The session status updates to `COMPLETED` when finished
**Full Replacement**: Completing a new import queue will **remove all companies** that were imported via previous API sessions. This is a complete replacement, not an append operation. If you need to retain previously imported companies, include them in your new import session.
## Notes
* The session must be in `PENDING` status to be completed
* Once completed, you cannot add more companies to this session
* If you need to import more companies, [start a new session](/api-reference/agent/start-import-queue)
* You can check the session status using the [import queue list](/api-reference/agent/import-queue) endpoint
# Get Import Queue Session
Source: https://docs.bizzy.ai/api-reference/v1/agent/get-import-queue-session
GET /v1/agents/import-queue/{sessionId}
Get details about a specific import queue session, including its current status and associated agent.
## Request
#### Path Parameters
The session ID returned from the [start import queue](/api-reference/agent/start-import-queue) endpoint
## Response
```json Response - 200 theme={null}
{
"sessionId": 3456789,
"agentId": 1234567,
"status": "PENDING"
}
```
```json Response - 404 theme={null}
{
"error": "Session not found"
}
```
The unique identifier for the import session
The ID of the agent this session belongs to
Current status of the import session. Can be one of:
* `PENDING` - Session is open and accepting companies
* `PROCESSING` - Session is being processed
* `COMPLETED` - Session has been successfully processed
## Use Cases
This endpoint is useful for:
* Checking the current status of an import session
* Verifying a session exists before adding companies
* Monitoring the progress of your import
## Notes
* You can only access sessions that belong to your team
* Use this endpoint to verify session status before calling [add companies](/api-reference/agent/add-companies)
# List Import Queue Sessions
Source: https://docs.bizzy.ai/api-reference/v1/agent/import-queue
GET /v1/agents/import-queue
Get a paginated list of all import queue sessions for your team. Each session represents a batch import operation. Sessions are returned in descending order by creation date (most recent first).
## Request
#### Query Parameters
The number of items to skip before starting to collect the result set
The maximum number of items to return
## Response
```json Response - 200 theme={null}
{
"data": [
{
"sessionId": 3456790,
"agentId": 1234567,
"status": "PENDING",
"createdAt": "2025-12-17T16:18:00.000Z"
},
{
"sessionId": 3456789,
"agentId": 1234567,
"status": "COMPLETED",
"createdAt": "2025-12-17T11:42:00.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
}
}
```
Array of import queue session objects
Unique identifier for the import session
The ID of the agent this session belongs to
Current status of the import session. Can be one of:
* `PENDING` - Session is open and accepting companies
* `PROCESSING` - Session is being processed
* `COMPLETED` - Session has been successfully processed
ISO 8601 timestamp of when the session was created
Pagination information
The maximum number of items returned in this response
The number of items skipped
The total number of sessions available
# Introduction
Source: https://docs.bizzy.ai/api-reference/v1/agent/introduction
**API v1 is deprecated and will no longer be supported after 15 November 2026.** Please migrate to [API v2](/api-reference/v2/company/introduction) before then. Questions? Contact [support@bizzy.ai](mailto:support@bizzy.ai).
The Agents API allows you to manage your sales agents and import companies into them programmatically. This is useful for integrating your own data sources and workflows with Bizzy's AI sales agents.
## Overview
The Agents API consists of two main parts:
1. **Agent Management**: List and view your sales agents
2. **Import Queue**: Batch import companies into your agents via a session-based workflow
## Import Queue Workflow
The import queue uses a session-based approach to handle batch imports:
1. **Start a session** - Create a new import queue session for a specific agent
2. **Add companies** - Add one or more companies to the session
3. **Complete** - Mark the session as complete to trigger processing
This workflow ensures that all companies in a batch are processed together as a single import operation.
**Full Replacement Model**: Completing a new import queue will **replace all existing companies** from previous imports. When you complete a new session, all companies previously imported via the API are removed before the new companies are added. This is a complete replacement.
## Prerequisites
Before importing companies via the API, ensure your agent has an API input channel configured in the Bizzy platform. This is required for the import queue to function properly.
# Agent Overview
Source: https://docs.bizzy.ai/api-reference/v1/agent/overview
GET /v1/agents
Get a paginated list of all agents in your team.
## Request
#### Query Parameters
The number of items to skip before starting to collect the result set
The maximum number of items to return
## Response
```json Response - 200 theme={null}
{
"data": [
{
"id": 1234567,
"name": "Enterprise Sales Agent",
"status": "ACTIVE",
"createdAt": "2025-12-17T09:23:00.000Z"
},
{
"id": 2345678,
"name": "SMB Outreach Agent",
"status": "ACTIVE",
"createdAt": "2025-12-17T14:37:00.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
}
}
```
Array of agent objects
Unique identifier for the agent
The name of the agent
The current status of the agent
ISO 8601 timestamp of when the agent was created
Pagination information
The maximum number of items returned in this response
The number of items skipped
The total number of agents available
# Start Import Queue
Source: https://docs.bizzy.ai/api-reference/v1/agent/start-import-queue
POST /v1/agents/import-queue
Create a new import queue session for a specific agent. This starts a batch import process that you can add companies to.
## Request
#### Body
The ID of the agent to import companies into (from the agent overview endpoint)
## Response
```json Response - 200 theme={null}
{
"sessionId": 3456789,
"agentId": 1234567
}
```
```json Response - 400 (No API Input Channel) theme={null}
{
"error": "Agent does not have an API input channel configured. Please configure an API input channel in platform before importing companies."
}
```
```json Response - 400 (Already Processing) theme={null}
{
"error": "Agent import queue already processing."
}
```
The unique identifier for the created import session. Use this ID to add companies and complete the session.
The ID of the agent this session belongs to
## Prerequisites
Before starting an import queue, ensure:
1. The agent has an **API input channel** configured in the Bizzy platform
2. No other import queue is currently processing for this agent
## Next Steps
After creating a session:
1. Use the returned `sessionId` to [add companies](/api-reference/agent/add-companies) to the queue
2. When all companies are added, [complete the session](/api-reference/agent/complete-import-queue) to trigger processing
**Important**: Completing a new import session will replace all companies from previous API imports. If you need to retain existing companies, include them in your new import session. See [Complete Import Queue](/api-reference/agent/complete-import-queue) for details.
# Contact Details
Source: https://docs.bizzy.ai/api-reference/v1/company/contactDetails
GET /v1/companies/{countryCode}/{companyNumber}/contacts/{contactId}
## Request
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
* ContactId is the unique identifier of the contact.
#### Query
Option to enrich the contact with email address. (If available)
Enriching costs credits - see the [Credit usage section](../credits)
Option to enrich the contact with mobile phone number. (If available)
Enriching costs credits - see the [Credit usage section](../credits)
## Response
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`
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`
Mobile phone in the following format: `+32 000 00 00 00`
The data provider of the mobile phone number.
* `PROSPEO`
* `CLEON1`
* `FORAGER`
Possible errors when enriching the mobile phone number.
* `RATE_LIMITED`
* `RATE_LIMITED_BURST`
* `INTERNAL_ERROR`
* `INVALID_INPUT`
```json Response - 200 theme={null}
{
"identifier": {
"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": "info@bizzy.ai", // Example
"status": "VALID"
},
"mobilePhone": {
"value": "+32 000 00 00 00", // Example
"dataProvider": "PROSPEO",
"error": null
}
}
}
```
# Contact Details
Source: https://docs.bizzy.ai/api-reference/v1/company/contactDetailsBulk
POST /v1/companies/contacts/details
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
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.
Option to enrich the contact with email address. (If available)
Enriching costs credits - see the [Credit usage section](../credits)
Option to enrich the contact with mobile phone number. (If available)
Enriching costs credits - see the [Credit usage section](../credits)
## Response
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`
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`
Mobile phone in the following format: `+32 000 00 00 00`
The data provider of the mobile phone number.
* `PROSPEO`
* `CLEON1`
* `FORAGER`
Possible errors when enriching the mobile phone number.
* `RATE_LIMITED`
* `RATE_LIMITED_BURST`
* `INTERNAL_ERROR`
* `INVALID_INPUT`
```json Response - 200 theme={null}
[
{
"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": "info@bizzy.ai", // 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"
},
]
```
# Contacts
Source: https://docs.bizzy.ai/api-reference/v1/company/contacts
GET /v1/companies/{countryCode}/{companyNumber}/contacts
## Request
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
#### Query
You can query on name or jobTitle.
Return only contacts with official roles.
Number of items to return per page. (max 500)
Number of items to skip.
You can chain multiple seniorities.
For example, use `C_LEVEL,NON_MANAGEMENT` to search for both C-Level and Non-Management roles.
* `C_LEVEL`
* `FOUNDER`
* `OWNER`
* `OFFICIAL_DIRECTOR`
* `PARTNER`
* `VP`
* `DIRECTOR`
* `SENIOR`
* `MANAGER`
* `ENTRY`
* `INTERN`
* `NON_MANAGEMENT`
You can chain multiple departments.
For example, use `SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT` to search for both Software-engineering and Product-Management 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`
You can chain multiple official roles.
For example, use `FOUNDER,COOWNER` to search for both Founder and Co-owner official roles.
* `ACTING_BAILIFF`
* `ADMINISTRATOR`
* `ASSOCIATE`
* `AUDITOR`
* `BOARD_MEMBER`
* `CHAIRMAN`
* `CHAIRMAN_OF_STATUTORY_AUDITORS`
* `CHARTERED_ACCOUNTANT`
* `CURATOR`
* `DEPUTY_MANAGING_DIRECTOR`
* `DEPUTY_PERMANENT_REPRESENTATIVE`
* `EXTERNAL_ACCOUNTANT`
* `FOUNDER`
* `GENERAL_ADMINISTRATOR`
* `GENERAL_AGENT`
* `GOVERNMENT_COMMISSIONER`
* `JUDICIAL_BOARD`
* `JUDICIAL_TRUSTEE`
* `LEGAL_REPRESENTATIVE`
* `MANAGER`
* `MANAGING_DIRECTOR`
* `MAYOR`
* `MEMBER_OF_AREA_ASSOCIATION`
* `PERMANENT_REPRESENTATIVE`
* `AUDITOR_PERMANENT_REPRESENTATIVE`
* `PERSON_IN_CHARGE`
* `PROPERTY_MANAGER`
* `REGISTERED_AUDITOR`
* `REGISTERED_TAX_EXPERT`
* `REPRESENTATIVE`
* `REPRESENTATIVE_NON_ADMIN`
* `SEQUESTER`
* `SUPPLY_SOLICITOR`
* `TREASURER`
* `TRUSTEE`
* `VICE_PRESIDENT`
* `SHAREHOLDER`
* `OTHER`
* `CIC_MANAGER`
* `LLP_MEMBER`
* `MANAGER_OF_AN_EEIG`
* `MEMBER_OF_A_MANAGEMENT_ORGAN`
* `MEMBER_OF_A_SUPERVISORY_ORGAN`
* `MEMBER_OF_AN_ADMINISTRATIVE_ORGAN`
* `NOMINEE_DIRECTOR`
* `NOMINEE_SECRETARY`
* `SECRETARY`
* `DIRECTOR`
* `GENERAL_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `JUDICIAL_FACTOR`
* `LIMITED_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `LLP_DESIGNATED_MEMBER`
* `PERSON_AUTHORISED_TO_ACCEPT`
* `PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT`
* `RECEIVER_AND_MANAGER`
* `ABSOLUTE_PARENT`
* `MEMBER`
* `MANAGEMENT_CONTROLLER`
* `ACCOUNT_CONTROLLER`
* `OTHER_MAJORITY_PARTNER`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_MANAGER_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_MANAGER_PARTNER`
* `LIQUIDATOR`
* `SOLE_PARTNER_ACTIVE_IN_EURL`
* `PRESIDENT_OF_BOARD_OF_DIRECTORS`
* `PRESIDENT_OF_EXECUTIVE_BOARD`
* `GENERAL_DIRECTOR`
* `FOREIGN_ENTITY_FOREIGN_EXECUTIVE`
* `FOREIGN_ENTITY_FRENCH_EXECUTIVE`
* `PRESIDENT_AND_GENERAL_DIRECTOR_OF_BOARD`
* `PRESIDENT_OF_SUPERVISORY_BOARD`
* `EXECUTIVE_BOARD_MEMBER`
* `SUPERVISORY_BOARD_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_COMPANY`
* `PERSON_AUTHORIZED_TO_REPRESENT_ESTABLISHMENT`
* `CHIEF_EXECUTIVE_OFFICER`
* `DEPUTY_GENERAL_DIRECTOR`
* `STATUTORY_AUDITOR`
* `ALTERNATE_AUDITOR`
* `PRESIDENT_OF_SAS`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_PARTNER`
* `FOREIGN_COMPANY_FRENCH_SOCIAL_REPRESENTATIVE`
* `FOREIGN_COMPANY_FRENCH_FISCAL_REPRESENTATIVE`
* `COOWNER`
* `OPERATOR_FOR_COOWNERSHIP`
* `PHYSICAL_PERSON_OPERATING_TOGETHER`
* `SPECIAL_AGENT`
* `TEMPORARY_ADMINISTRATOR`
* `UNSALARIED_MEMBER_PARTICIPATING_IN_WORK`
* `PARTNER_INVOLVED_IN_MANAGEMENT`
* `UNSALARIED_PARTNER`
* `ACQUIRER`
* `ENTREPRENEUR`
* `DEPUTY`
* `DESIGNATED_DECISION_MAKER`
* `ACCOUNTANT`
* `COOWNER_HEIR`
* `LESSOR`
* `BENIFICIAL_OWNER`
* `TAX_AGENT`
* `VICE_PRESIDENT_MANAGEMENT`
* `VICE_PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `MEMBER_ORIENTATION_AND_SURVEILLANCE`
* `SOLE_PARTNER_ASSET_RECOVERY`
* `GENERAL_PARTNER`
* `PRESIDENT_OF_EPIC`
* `LAWYER`
* `TAX_REPRESENTATIVE`
* `BENFICIAL_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_ENTITY`
* `PRESIDENT`
* `GENERAL_SECRETARY`
* `UNION_BOARD_MEMBER`
* `UNION_BOARD_PRESIDENT`
* `PERSON_DESIGNATED_BY_BYLAWS`
## 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.
```json Response - 200 theme={null}
{
"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
}
}
```
# Contacts
Source: https://docs.bizzy.ai/api-reference/v1/company/contactsBulk
POST /v1/companies/contacts
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
You can request up to 100 companies at once.
You can query on name or jobTitle.
Return only contacts with official roles.
Number of items to return per page. (max 500)
Number of items to skip.
You can chain multiple seniorities.
For example, use `C_LEVEL,NON_MANAGEMENT` to search for both C-Level and Non-Management roles.
* `C_LEVEL`
* `FOUNDER`
* `OWNER`
* `OFFICIAL_DIRECTOR`
* `PARTNER`
* `VP`
* `DIRECTOR`
* `SENIOR`
* `MANAGER`
* `ENTRY`
* `INTERN`
* `NON_MANAGEMENT`
You can chain multiple departments.
For example, use `SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT` to search for both Software-engineering and Product-Management 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`
You can chain multiple official roles.
For example, use `FOUNDER,COOWNER` to search for both Founder and Co-owner official roles.
* `ACTING_BAILIFF`
* `ADMINISTRATOR`
* `ASSOCIATE`
* `AUDITOR`
* `BOARD_MEMBER`
* `CHAIRMAN`
* `CHAIRMAN_OF_STATUTORY_AUDITORS`
* `CHARTERED_ACCOUNTANT`
* `CURATOR`
* `DEPUTY_MANAGING_DIRECTOR`
* `DEPUTY_PERMANENT_REPRESENTATIVE`
* `EXTERNAL_ACCOUNTANT`
* `FOUNDER`
* `GENERAL_ADMINISTRATOR`
* `GENERAL_AGENT`
* `GOVERNMENT_COMMISSIONER`
* `JUDICIAL_BOARD`
* `JUDICIAL_TRUSTEE`
* `LEGAL_REPRESENTATIVE`
* `MANAGER`
* `MANAGING_DIRECTOR`
* `MAYOR`
* `MEMBER_OF_AREA_ASSOCIATION`
* `PERMANENT_REPRESENTATIVE`
* `AUDITOR_PERMANENT_REPRESENTATIVE`
* `PERSON_IN_CHARGE`
* `PROPERTY_MANAGER`
* `REGISTERED_AUDITOR`
* `REGISTERED_TAX_EXPERT`
* `REPRESENTATIVE`
* `REPRESENTATIVE_NON_ADMIN`
* `SEQUESTER`
* `SUPPLY_SOLICITOR`
* `TREASURER`
* `TRUSTEE`
* `VICE_PRESIDENT`
* `SHAREHOLDER`
* `OTHER`
* `CIC_MANAGER`
* `LLP_MEMBER`
* `MANAGER_OF_AN_EEIG`
* `MEMBER_OF_A_MANAGEMENT_ORGAN`
* `MEMBER_OF_A_SUPERVISORY_ORGAN`
* `MEMBER_OF_AN_ADMINISTRATIVE_ORGAN`
* `NOMINEE_DIRECTOR`
* `NOMINEE_SECRETARY`
* `SECRETARY`
* `DIRECTOR`
* `GENERAL_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `JUDICIAL_FACTOR`
* `LIMITED_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `LLP_DESIGNATED_MEMBER`
* `PERSON_AUTHORISED_TO_ACCEPT`
* `PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT`
* `RECEIVER_AND_MANAGER`
* `ABSOLUTE_PARENT`
* `MEMBER`
* `MANAGEMENT_CONTROLLER`
* `ACCOUNT_CONTROLLER`
* `OTHER_MAJORITY_PARTNER`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_MANAGER_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_MANAGER_PARTNER`
* `LIQUIDATOR`
* `SOLE_PARTNER_ACTIVE_IN_EURL`
* `PRESIDENT_OF_BOARD_OF_DIRECTORS`
* `PRESIDENT_OF_EXECUTIVE_BOARD`
* `GENERAL_DIRECTOR`
* `FOREIGN_ENTITY_FOREIGN_EXECUTIVE`
* `FOREIGN_ENTITY_FRENCH_EXECUTIVE`
* `PRESIDENT_AND_GENERAL_DIRECTOR_OF_BOARD`
* `PRESIDENT_OF_SUPERVISORY_BOARD`
* `EXECUTIVE_BOARD_MEMBER`
* `SUPERVISORY_BOARD_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_COMPANY`
* `PERSON_AUTHORIZED_TO_REPRESENT_ESTABLISHMENT`
* `CHIEF_EXECUTIVE_OFFICER`
* `DEPUTY_GENERAL_DIRECTOR`
* `STATUTORY_AUDITOR`
* `ALTERNATE_AUDITOR`
* `PRESIDENT_OF_SAS`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_PARTNER`
* `FOREIGN_COMPANY_FRENCH_SOCIAL_REPRESENTATIVE`
* `FOREIGN_COMPANY_FRENCH_FISCAL_REPRESENTATIVE`
* `COOWNER`
* `OPERATOR_FOR_COOWNERSHIP`
* `PHYSICAL_PERSON_OPERATING_TOGETHER`
* `SPECIAL_AGENT`
* `TEMPORARY_ADMINISTRATOR`
* `UNSALARIED_MEMBER_PARTICIPATING_IN_WORK`
* `PARTNER_INVOLVED_IN_MANAGEMENT`
* `UNSALARIED_PARTNER`
* `ACQUIRER`
* `ENTREPRENEUR`
* `DEPUTY`
* `DESIGNATED_DECISION_MAKER`
* `ACCOUNTANT`
* `COOWNER_HEIR`
* `LESSOR`
* `BENIFICIAL_OWNER`
* `TAX_AGENT`
* `VICE_PRESIDENT_MANAGEMENT`
* `VICE_PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `MEMBER_ORIENTATION_AND_SURVEILLANCE`
* `SOLE_PARTNER_ASSET_RECOVERY`
* `GENERAL_PARTNER`
* `PRESIDENT_OF_EPIC`
* `LAWYER`
* `TAX_REPRESENTATIVE`
* `BENFICIAL_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_ENTITY`
* `PRESIDENT`
* `GENERAL_SECRETARY`
* `UNION_BOARD_MEMBER`
* `UNION_BOARD_PRESIDENT`
* `PERSON_DESIGNATED_BY_BYLAWS`
## 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.
```json Response - 200 theme={null}
[
{
"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
},
"message": null
},
{
"identifier": { // Example error
"country": "BE",
"companyNumber": "123"
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Details
Source: https://docs.bizzy.ai/api-reference/v1/company/details
GET /v1/companies/{countryCode}/{companyNumber}
## Request
#### Header
* NL: Dutch
* FR: French
* EN: English
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
## Response
The following fields can have a set of values:
```json Response - 200 theme={null}
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy AI",
"place": "Gent"
},
"data": {
"vatNumber": "BE0770.493.071",
"status": "ACTIVE",
"legalStatus": "NORMAL_SITUATION",
"description": "Bizzy is a B2B intelligence platform that uses AI and machine learning to provide sales professionals, marketers, and investors with real-time insights and data on companies. Their solution helps users discover, qualify, and engage with companies more efficiently, allowing them to focus on the right leads and opportunities.",
"logo": "https://bizzy.ams3.digitaloceanspaces.com/prod/companies/be/logos/fa6fd26d-f23a-416a-822e-624a0eca6e3b/100075701964481.png",
"establishedSince": "2021-06-29T00:00:00.000Z",
"stoppedSince": null,
"entityType": "LEGAL_PERSON",
"companyTypeCode": "PLC",
"name": "Bizzy AI",
"tradeNames": [
{
"name": "Bizzy AI"
},
{
"name": "Bizzy"
}
],
"address": {
"country": "BE",
"street": "Dok-Noord",
"number": "4E",
"box": "//4",
"postalCode": "9000",
"place": "Gent"
},
"website": [
"https://bizzy.ai"
],
"socials": {
"x": "https://twitter.com/bizzyinsights",
"facebook": "https://www.facebook.com/bizzyinsights",
"youtube": null,
"instagram": "https://www.instagram.com/bizzyinsights/",
"linkedin": "https://www.linkedin.com/company/bizzyinsights/"
},
"contact": {
"email": "hello@bizzy.ai",
"phone": null
},
"naceCodes": [
{
"code": "62010"
},
{
"code": "62020"
},
{
"code": "62090"
},
{
"code": "70220"
}
],
"activities": [
{
"activity": "BUSINESS_CONSULTING"
},
{
"activity": "DATA_ANALYTICS"
}
],
"revenueEstimations": "Bucket0_1M",
"employeeEstimations": "Bucket10_19",
"commonScore": "C",
"creditLimit": 500
}
}
```
status can be either `ACTIVE` or `INACTIVE`
legalStatus can be one of the following:
* `NORMAL_SITUATION`
* `LEGAL_CREATION`
* `EX_OFFICIO_LIQUIDATION_AFTER_TERM_EXPIRATION`
* `CESSATION_OF_ACTIVITIES_IN_COUNTRY`
* `VOLUNTARY_DISSOLUTIONVOLUNTARY_LIQUIDATION`
* `COMPULSORY_DISSOLUTION`
* `END_OF_DISSOLUTION`
* `START_OF_DISSOLUTION`
* `CESSATION_OF_ENTITY_WITHOUT_LEGAL_PERSONALITY`
* `CESSATIONTRANSFER_OF_REGISTERED_ENTITY_NATURAL_PERSON`
* `CESSATION_DURING_IDENTIFICATION`
* `CESSATION_OF_EDRL_OR_NON_EU_ENTITY`
* `SHARES_HELD_BY_SINGLE_SHAREHOLDER`
* `MERGER_BY_ACQUISITION`
* `MERGER_BY_FORMATION`
* `DIVISION`
* `DIVISION_BY_ABSORPTION`
* `DIVISION_BY_FORMATION`
* `MIXED_DIVISION`
* `SETTLEMENT_BEFORE_BANKRUPTCY`
* `SETTLEMENT_AFTER_BANKRUPTCY`
* `TEMPORARY_DEFERMENT_OF_PAYMENT`
* `PERMANENT_DEFERMENT_OF_PAYMENT`
* `REVOCATION_OF_DEFERMENT`
* `END_OF_DEFERMENT`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE`
* `CLOSING_OF_BANKRUPTCY_PROCEDURE`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `DEFERMENT`
* `ENTITY_IDENTIFICATION`
* `STRIKING_OFF_FOLLOWING_CESSATION_IN_REGISTER_IN_THE_EEA`
* `REOPENING_LIQUIDATION`
* `REOPENING_DISOLUTION`
* `COMPULSORY_DISSOLUTION_OR_NULLIFICATION`
* `RECEIVER_APPOINTED`
* `VOLUNTARY_ARRANGEMENT`
* `CHANGED_COMPANY_TYPE`
* `DE_REGISTERED`
entityType can be either `LEGAL_PERSON` or `NATURAL_PERSON`
| Code | Description |
| -------- | ---------------------------------------------------------------------------------- |
| AGRICO | agricultural company |
| AUMUCO | autonomous municipal company |
| AUPRCO | autonomous provincial company |
| BRUSCR | brussels-capital region authorities |
| CITIES | cities and municipalities |
| CSUNCS | civil society as an unlimited liability and united cs |
| CSCOLS | civil society in the form of a collective society |
| CSLPS | civil society in the form of a limit partnership with shares |
| CSLLCS | civil society in the form of a limited liability cs |
| CSLPAR | civil society in the form of a limited partnership |
| CSPLLC | civil society in the form of a private limited liability company |
| CSPLCO | civil society in the form of a public limited company |
| CSAGCO | civil society in the form of an agricultural company |
| COOWN | co-ownership association |
| COMLCO | common law company |
| COFORM | company in formation |
| CAWOLP | company or association without legal personality |
| CONCOM | congolese company |
| CSOR | cooperative society (old regime) |
| CSPLOR | cooperative society governed by public law (old regime) |
| CSPL | cooperative society governed by public law |
| CSLLPS | cooperative society with limited liability (profit share) |
| CSLLSO | cooperative society with limited liability and a social objective |
| CSLLPP | cooperative society with limited liability governed by public law (profit share) |
| CSLLPL | cooperative society with limited liability governed by public law |
| CSLL | cooperative society with limited liability |
| CSULPS | cooperative society with unlimited liability (profit share) |
| CSULSO | cooperative society with unlimited liability and a social objective |
| CSULPP | cooperative society with unlimited liability governed by public law (profit share) |
| CSULPL | cooperative society with unlimited liability governed by public law |
| CSUL | cooperative society with unlimited liability |
| CS | cooperative society |
| CPASAS | cpas / ocmw association |
| CULT | cult |
| ECASBE | econ. assoc wo regist. seat but with est. unit in belgium |
| EIGSO | economic interest grouping with a social objective |
| EIG | economic interest grouping with registered seat in belgium |
| EEAWOH | europ. econ. assoc wo reg.seat but with est. unit in belgium |
| SE | european company (societas europaea) |
| SCE | european cooperative society |
| EEABE | european economic assoc with registered seat in belgium |
| EUPOLF | european political foundation |
| EUPOLP | european political party |
| EXPASS | expense association |
| FPPS | federal public planning service |
| FPS | federal public service |
| FLEMRC | flemish region and flemish community authorities |
| FLEMRC | flemish region and flemish community authority |
| FEPBE | foreign ent. with property in belgium (without legal pers.) |
| FEPIBLP | foreign entity with property in belgium (with legal personality) |
| FEWOUVAT | foreign entity without belgian establishment unit with vat representation |
| FORENT | foreign entity |
| FCOWHE | foreign listed company without belgian establishment unit |
| FPUORG | foreign or international public organisations |
| FRENCH | french community authorities |
| GPSO | general partnership with a social objective |
| GENPAR | general partnership |
| GERMAN | german-speaking community authorities |
| HEALTH | health fund / mutual health insurance / national union of health funds |
| HULPVZ | hulpverleningszone |
| INTERC | intercommunal |
| INTCO | internal company |
| INPASSPL | international non-profit association governed by public law |
| INPASS | international non-profit association |
| ISCORG | international scientific organisation under belgian law |
| LPPL | limited partnership governed by public law |
| LTDPRTN | limited partnership |
| LOCPOL | local police |
| MINMC | ministry for middle class |
| MINAGR | ministry of agriculture |
| MINECO | ministry of economic affairs |
| MINEMP | ministry of employment and labour |
| MINFIN | ministry of finance |
| MINFOR | ministry of foreign affairs |
| MINHAF | ministry of home affairs |
| MINJUS | ministry of justice |
| MINDEF | ministry of national defence |
| MINEDU | ministry of national education and culture |
| MINHEA | ministry of public health and family |
| MINSER | ministry of public service |
| MINRW | ministry of road works |
| MINSEA | ministry of self-employed and agriculture |
| MINSAH | ministry of social affair public health and environment |
| MINSWF | ministry of social welfare |
| MINBCR | ministry of the brussels-capital region |
| MINFLC | ministry of the flemish community |
| MINFRC | ministry of the french community |
| MINGSC | ministry of the german-speaking community |
| MINWAR | ministry of the walloon region |
| MINTIN | ministry of traffic and infrastructure |
| MIWOLP | miscellaneous without legal personality |
| MISC | miscellaneous |
| NPROFI | non-profit institution |
| NPROF | non-profit organisation |
| LTDPSO | ordinary limited partnership with a social objective |
| OLP | ordinary limited partnership |
| ORGPUP | organis. regist. with the public admin. pensions (finance) |
| NSSOLR | organisations registered through the onssapl |
| ORGONP | organisations registered with the o.n.p |
| OTHFS | other federal services |
| OTHISO | other institution with a social objective (public) |
| OTHER | other legal form |
| OTHPRI | other private organisation with legal personality |
| LTPSSO | partnership limited by shares with a social objective |
| PLTDSH | partnership limited by shares |
| PAWN | pawnshop |
| PENSIO | pension scheme organisation |
| POLDER | polders and water boards |
| PREZON | prezone |
| PFA | private foreign association with establishment in belgium |
| PFA | private foreign association with establishment unit |
| PFA | private foreign association with establishmen agenc office or branch in belgium |
| PRIVFO | private foundation |
| PLCPL | private limited company governed by public law |
| PLC | private limited company |
| PRLCSO | private limited liability company with a social objective |
| PLIMLC | private limited liability company |
| MUTINS | private mutual insurance fund |
| PROFCO | professional corporations - orders |
| PROFUN | professional union |
| PROJAS | project association |
| PROVAU | provincial authorities |
| PROVAU | provincial authority |
| PSOACT | pubic social action centre |
| PUBINS | public institution |
| PLCSO | public limited company with a social objective |
| PLIMCO | public limited company |
| MUTINS | public mutual insurance fund |
| PNPASS | public non-profit association |
| PUBLUF | public utility foundation |
| PUBLUT | public utility institution |
| REPRAS | representative association (flemish region) |
| SEPRAS | service provider association (flemish region) |
| SPRC | stat provinc regio community |
| TEMPAS | temporary association |
| TEMPCO | temporary company |
| SPRMIN | the services of the prime minister |
| TUNION | trade union |
| ULPCSO | unipersonal private limited liability company with a social objective |
| UNNSSO | unkown legal form (nsso) |
| UNLCC | unlawful commercial company |
| VATGR | vat-group |
| WALLRA | walloon region authorities |
| EMZ | sole proprietorship |
| Code | Description |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Organisme de placement collectif en valeurs mobilières sans personnalité morale |
| 1000 | Entrepreneur individuel |
| 2110 | Indivision entre personnes physiques |
| 2120 | Indivision avec personne morale |
| 2210 | Société créée de fait entre personnes physiques |
| 2220 | Société créée de fait avec personne morale |
| 2310 | Société en participation entre personnes physiques |
| 2320 | Société en participation avec personne morale |
| 2385 | Société en participation de professions libérales |
| 2400 | Fiducie |
| 2700 | Paroisse hors zone concordataire |
| 2800 | Assujetti unique à la TVA |
| 2900 | Autre groupement de droit privé non doté de la personnalité morale |
| 3110 | Représentation ou agence commerciale d'état ou organisme public étranger immatriculé au RCS |
| 3120 | Société commerciale étrangère immatriculée au RCS |
| 3205 | Organisation internationale |
| 3210 | État, collectivité ou établissement public étranger |
| 3220 | Société étrangère non immatriculée au RCS |
| 3290 | Autre personne morale de droit étranger |
| 4110 | Établissement public national à caractère industriel ou commercial doté d'un comptable public |
| 4120 | Établissement public national à caractère industriel ou commercial non doté d'un comptable public |
| 4130 | Exploitant public |
| 4140 | Établissement public local à caractère industriel ou commercial |
| 4150 | Régie d'une collectivité locale à caractère industriel ou commercial |
| 4160 | Institution Banque de France |
| 5191 | Société de caution mutuelle |
| 5192 | Société coopérative de banque populaire |
| 5193 | Caisse de crédit maritime mutuel |
| 5194 | Caisse (fédérale) de crédit mutuel |
| 5195 | Association coopérative inscrite (droit local Alsace Moselle) |
| 5196 | Caisse d'épargne et de prévoyance à forme coopérative |
| 5202 | Société en nom collectif |
| 5203 | Société en nom collectif coopérative |
| 5306 | Société en commandite simple |
| 5307 | Société en commandite simple coopérative |
| 5308 | Société en commandite par actions |
| 5309 | Société en commandite par actions coopérative |
| 5310 | Société en libre partenariat (SLP) |
| 5370 | Société de Participations Financières de Profession Libérale Société en commandite par actions (SPFPL SCA) |
| 5385 | Société d'exercice libéral en commandite par actions |
| 5410 | SARL nationale |
| 5415 | SARL d'économie mixte |
| 5422 | SARL immobilière pour le commerce et l'industrie (SICOMI) |
| 5426 | SARL immobilière de gestion |
| 5430 | SARL d'aménagement foncier et d'équipement rural (SAFER) |
| 5431 | SARL mixte d'intérêt agricole (SMIA) |
| 5432 | SARL d'intérêt collectif agricole (SICA) |
| 5442 | SARL d'attribution |
| 5443 | SARL coopérative de construction |
| 5451 | SARL coopérative de consommation |
| 5453 | SARL coopérative artisanale |
| 5454 | SARL coopérative d'intérêt maritime |
| 5455 | SARL coopérative de transport |
| 5458 | SARL coopérative de production (SCOP) |
| 5459 | SARL union de sociétés coopératives |
| 5460 | Autre SARL coopérative |
| 5470 | Société de Participations Financières de Profession Libérale Société à responsabilité limitée (SPFPL SARL) |
| 5485 | Société d'exercice libéral à responsabilité limitée |
| 5499 | Société à responsabilité limitée (sans autre indication) |
| 5505 | SA à participation ouvrière à conseil d'administration |
| 5510 | SA nationale à conseil d'administration |
| 5515 | SA d'économie mixte à conseil d'administration |
| 5520 | Fonds à forme sociétale à conseil d'administration |
| 5522 | SA immobilière pour le commerce et l'industrie (SICOMI) à conseil d'administration |
| 5525 | SA immobilière d'investissement à conseil d'administration |
| 5530 | SA d'aménagement foncier et d'équipement rural (SAFER) à conseil d'administration |
| 5531 | Société anonyme mixte d'intérêt agricole (SMIA) à conseil d'administration |
| 5532 | SA d'intérêt collectif agricole (SICA) à conseil d'administration |
| 5542 | SA d'attribution à conseil d'administration |
| 5543 | SA coopérative de construction à conseil d'administration |
| 5546 | SA de HLM à conseil d'administration |
| 5547 | SA coopérative de production de HLM à conseil d'administration |
| 5548 | SA de crédit immobilier à conseil d'administration |
| 5551 | SA coopérative de consommation à conseil d'administration |
| 5552 | SA coopérative de commerçants-détaillants à conseil d'administration |
| 5553 | SA coopérative artisanale à conseil d'administration |
| 5554 | SA coopérative (d'intérêt) maritime à conseil d'administration |
| 5555 | SA coopérative de transport à conseil d'administration |
| 5558 | SA coopérative de production (SCOP) à conseil d'administration |
| 5559 | SA union de sociétés coopératives à conseil d'administration |
| 5560 | Autre SA coopérative à conseil d'administration |
| 5570 | Société de Participations Financières de Profession Libérale Société anonyme à conseil d'administration (SPFPL SA à conseil d'administration) |
| 5585 | Société d'exercice libéral à forme anonyme à conseil d'administration |
| 5599 | SA à conseil d'administration (s.a.i.) |
| 5605 | SA à participation ouvrière à directoire |
| 5610 | SA nationale à directoire |
| 5615 | SA d'économie mixte à directoire |
| 5620 | Fonds à forme sociétale à directoire |
| 5622 | SA immobilière pour le commerce et l'industrie (SICOMI) à directoire |
| 5625 | SA immobilière d'investissement à directoire |
| 5630 | Safer anonyme à directoire |
| 5631 | SA mixte d'intérêt agricole (SMIA) |
| 5632 | SA d'intérêt collectif agricole (SICA) |
| 5642 | SA d'attribution à directoire |
| 5643 | SA coopérative de construction à directoire |
| 5646 | SA de HLM à directoire |
| 5647 | Société coopérative de production de HLM anonyme à directoire |
| 5648 | SA de crédit immobilier à directoire |
| 5651 | SA coopérative de consommation à directoire |
| 5652 | SA coopérative de commerçants-détaillants à directoire |
| 5653 | SA coopérative artisanale à directoire |
| 5654 | SA coopérative d'intérêt maritime à directoire |
| 5655 | SA coopérative de transport à directoire |
| 5658 | SA coopérative de production (SCOP) à directoire |
| 5659 | SA union de sociétés coopératives à directoire |
| 5660 | Autre SA coopérative à directoire |
| 5670 | Société de Participations Financières de Profession Libérale Société anonyme à Directoire (SPFPL SA à directoire) |
| 5685 | Société d'exercice libéral à forme anonyme à directoire |
| 5699 | SA à directoire (s.a.i.) |
| 5710 | SAS, société par actions simplifiée |
| 5770 | Société de Participations Financières de Profession Libérale Société par actions simplifiée (SPFPL SAS) |
| 5785 | Société d'exercice libéral par action simplifiée |
| 5800 | Société européenne |
| 6100 | Caisse d'Épargne et de Prévoyance |
| 6210 | Groupement européen d'intérêt économique (GEIE) |
| 6220 | Groupement d'intérêt économique (GIE) |
| 6316 | Coopérative d'utilisation de matériel agricole en commun (CUMA) |
| 6317 | Société coopérative agricole |
| 6318 | Union de sociétés coopératives agricoles |
| 6411 | Société d'assurance à forme mutuelle |
| 6511 | Sociétés Interprofessionnelles de Soins Ambulatoires |
| 6521 | Société civile de placement collectif immobilier (SCPI) |
| 6532 | Société civile d'intérêt collectif agricole (SICA) |
| 6533 | Groupement agricole d'exploitation en commun (GAEC) |
| 6534 | Groupement foncier agricole |
| 6535 | Groupement agricole foncier |
| 6536 | Groupement forestier |
| 6537 | Groupement pastoral |
| 6538 | Groupement foncier et rural |
| 6539 | Société civile foncière |
| 6540 | Société civile immobilière |
| 6541 | Société civile immobilière de construction-vente |
| 6542 | Société civile d'attribution |
| 6543 | Société civile coopérative de construction |
| 6544 | Société civile immobilière d' accession progressive à la propriété |
| 6551 | Société civile coopérative de consommation |
| 6554 | Société civile coopérative d'intérêt maritime |
| 6558 | Société civile coopérative entre médecins |
| 6560 | Autre société civile coopérative |
| 6561 | SCP d'avocats |
| 6562 | SCP d'avocats aux conseils |
| 6563 | SCP d'avoués d'appel |
| 6564 | SCP d'huissiers |
| 6565 | SCP de notaires |
| 6566 | SCP de commissaires-priseurs |
| 6567 | SCP de greffiers de tribunal de commerce |
| 6568 | SCP de conseils juridiques |
| 6569 | SCP de commissaires aux comptes |
| 6571 | SCP de médecins |
| 6572 | SCP de dentistes |
| 6573 | SCP d'infirmiers |
| 6574 | SCP de masseurs-kinésithérapeutes |
| 6575 | SCP de directeurs de laboratoire d'analyse médicale |
| 6576 | SCP de vétérinaires |
| 6577 | SCP de géomètres experts |
| 6578 | SCP d'architectes |
| 6585 | Autre société civile professionnelle |
| 6589 | Société civile de moyens |
| 6595 | Caisse locale de crédit mutuel |
| 6596 | Caisse de crédit agricole mutuel |
| 6597 | Société civile d'exploitation agricole |
| 6598 | Exploitation agricole à responsabilité limitée |
| 6599 | Autre société civile |
| 6901 | Autre personne de droit privé inscrite au registre du commerce et des sociétés |
| 7111 | Autorité constitutionnelle |
| 7112 | Autorité administrative ou publique indépendante |
| 7113 | Ministère |
| 7120 | Service central d'un ministère |
| 7150 | Service du ministère de la Défense |
| 7160 | Service déconcentré à compétence nationale d'un ministère (hors Défense) |
| 7171 | Service déconcentré de l'État à compétence (inter) régionale |
| 7172 | Service déconcentré de l'État à compétence (inter) départementale |
| 7179 | (Autre) Service déconcentré de l'État à compétence territoriale |
| 7190 | Ecole nationale non dotée de la personnalité morale |
| 7210 | Commune et commune nouvelle |
| 7220 | Département |
| 7225 | Collectivité et territoire d'Outre Mer |
| 7229 | (Autre) Collectivité territoriale |
| 7230 | Région |
| 7312 | Commune associée et commune déléguée |
| 7313 | Section de commune |
| 7314 | Ensemble urbain |
| 7321 | Association syndicale autorisée |
| 7322 | Association foncière urbaine |
| 7323 | Association foncière de remembrement |
| 7331 | Établissement public local d'enseignement |
| 7340 | Pôle métropolitain |
| 7341 | Secteur de commune |
| 7342 | District urbain |
| 7343 | Communauté urbaine |
| 7344 | Métropole |
| 7345 | Syndicat intercommunal à vocation multiple (SIVOM) |
| 7346 | Communauté de communes |
| 7347 | Communauté de villes |
| 7348 | Communauté d'agglomération |
| 7349 | Autre établissement public local de coopération non spécialisé ou entente |
| 7351 | Institution interdépartementale ou entente |
| 7352 | Institution interrégionale ou entente |
| 7353 | Syndicat intercommunal à vocation unique (SIVU) |
| 7354 | Syndicat mixte fermé |
| 7355 | Syndicat mixte ouvert |
| 7356 | Commission syndicale pour la gestion des biens indivis des communes |
| 7357 | Pôle d'équilibre territorial et rural (PETR) |
| 7361 | Centre communal d'action sociale |
| 7362 | Caisse des écoles |
| 7363 | Caisse de crédit municipal |
| 7364 | Établissement d'hospitalisation |
| 7365 | Syndicat inter hospitalier |
| 7366 | Établissement public local social et médico-social |
| 7367 | Centre Intercommunal d'action sociale (CIAS) |
| 7371 | Office public d'habitation à loyer modéré (OPHLM) |
| 7372 | Service départemental d'incendie et de secours (SDIS) |
| 7373 | Établissement public local culturel |
| 7378 | Régie d'une collectivité locale à caractère administratif |
| 7379 | (Autre) Établissement public administratif local |
| 7381 | Organisme consulaire |
| 7382 | Établissement public national ayant fonction d'administration centrale |
| 7383 | Établissement public national à caractère scientifique culturel et professionnel |
| 7384 | Autre établissement public national d'enseignement |
| 7385 | Autre établissement public national administratif à compétence territoriale limitée |
| 7389 | Établissement public national à caractère administratif |
| 7410 | Groupement d'intérêt public (GIP) |
| 7430 | Établissement public des cultes d'Alsace-Lorraine |
| 7450 | Etablissement public administratif, cercle et foyer dans les armées |
| 7470 | Groupement de coopération sanitaire à gestion publique |
| 7490 | Autre personne morale de droit administratif |
| 8110 | Régime général de la Sécurité Sociale |
| 8120 | Régime spécial de Sécurité Sociale |
| 8130 | Institution de retraite complémentaire |
| 8140 | Mutualité sociale agricole |
| 8150 | Régime maladie des non-salariés non agricoles |
| 8160 | Régime vieillesse ne dépendant pas du régime général de la Sécurité Sociale |
| 8170 | Régime d'assurance chômage |
| 8190 | Autre régime de prévoyance sociale |
| 8210 | Mutuelle |
| 8250 | Assurance mutuelle agricole |
| 8290 | Autre organisme mutualiste |
| 8310 | Comité social économique d’entreprise |
| 8311 | Comité social économique d'établissement |
| 8410 | Syndicat de salariés |
| 8420 | Syndicat patronal |
| 8450 | Ordre professionnel ou assimilé |
| 8470 | Centre technique industriel ou comité professionnel du développement économique |
| 8490 | Autre organisme professionnel |
| 8510 | Institution de prévoyance |
| 8520 | Institution de retraite supplémentaire |
| 9110 | Syndicat de copropriété |
| 9150 | Association syndicale libre |
| 9210 | Association non déclarée |
| 9220 | Association déclarée |
| 9221 | Association déclarée d'insertion par l'économique |
| 9222 | Association intermédiaire |
| 9223 | Groupement d'employeurs |
| 9224 | Association d'avocats à responsabilité professionnelle individuelle |
| 9230 | Association déclarée, reconnue d'utilité publique |
| 9240 | Congrégation |
| 9260 | Association de droit local (Bas-Rhin, Haut-Rhin et Moselle) |
| 9300 | Fondation |
| 9900 | Autre personne morale de droit privé |
| 9970 | Groupement de coopération sanitaire à gestion privée |
| Code | Description |
| ---- | -------------------------------------------------------- |
| BV | Besloten Vennootschap |
| VVE | Vereniging van Eigenaars |
| VOF | Vennootschap Onder firma |
| VER | Vereniging |
| ST | Stichting |
| COP | Coöperatie |
| KG | Kerkgenootschap |
| CV | Commanditaire Vennootschap |
| MA | Maatschap |
| NV | Naamloze Vennootschap |
| BR | Buitenlandse Rechtsvorm |
| OWM | Onderlinge Waarborg Maatschappij |
| RIO | Rechtsperoon in oprichting |
| RIO | Rechtspersoon in oprichting |
| PR | Publiekrechtelijke Rechtspersoon |
| SE | Europese naamloze vennootschap (SE) |
| OPR | Overige Privaatrechtelijke Rechtspersoon |
| EESV | Europees economisch samenwerkingsverband |
| EMZ | Eenmanszaak |
| SE | Europese naamloze vennootschap (SE) met gewone structuur |
| RED | Rederij |
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
Common score is a score provided by CreditSafe that predicts the likelihood of a company becoming insolvent or bankrupt within the next 12 months
| Score | Description |
| ----- | -------------- |
| A | Very low risk |
| B | Low risk |
| C | Moderate risk |
| D | High risk |
| E | Very high risk |
This is the credit limit provided by CreditSafe. It is the recommended maximum amount of credit that can be safely extended to a company at one time.
The email address of the company
The international phone number of the company
'Do Not Call Me' flag
# Bulk Details
Source: https://docs.bizzy.ai/api-reference/v1/company/detailsBulk
POST /v1/companies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
You can request up to 100 companies at once.
## Response
The following data fields can have a set of values:
status can be either `ACTIVE` or `INACTIVE`
legalStatus can be one of the following:
* `NORMAL_SITUATION`
* `LEGAL_CREATION`
* `EX_OFFICIO_LIQUIDATION_AFTER_TERM_EXPIRATION`
* `CESSATION_OF_ACTIVITIES_IN_COUNTRY`
* `VOLUNTARY_DISSOLUTIONVOLUNTARY_LIQUIDATION`
* `COMPULSORY_DISSOLUTION`
* `END_OF_DISSOLUTION`
* `START_OF_DISSOLUTION`
* `CESSATION_OF_ENTITY_WITHOUT_LEGAL_PERSONALITY`
* `CESSATIONTRANSFER_OF_REGISTERED_ENTITY_NATURAL_PERSON`
* `CESSATION_DURING_IDENTIFICATION`
* `CESSATION_OF_EDRL_OR_NON_EU_ENTITY`
* `SHARES_HELD_BY_SINGLE_SHAREHOLDER`
* `MERGER_BY_ACQUISITION`
* `MERGER_BY_FORMATION`
* `DIVISION`
* `DIVISION_BY_ABSORPTION`
* `DIVISION_BY_FORMATION`
* `MIXED_DIVISION`
* `SETTLEMENT_BEFORE_BANKRUPTCY`
* `SETTLEMENT_AFTER_BANKRUPTCY`
* `TEMPORARY_DEFERMENT_OF_PAYMENT`
* `PERMANENT_DEFERMENT_OF_PAYMENT`
* `REVOCATION_OF_DEFERMENT`
* `END_OF_DEFERMENT`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE`
* `CLOSING_OF_BANKRUPTCY_PROCEDURE`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `DEFERMENT`
* `ENTITY_IDENTIFICATION`
* `STRIKING_OFF_FOLLOWING_CESSATION_IN_REGISTER_IN_THE_EEA`
* `REOPENING_LIQUIDATION`
* `REOPENING_DISOLUTION`
* `COMPULSORY_DISSOLUTION_OR_NULLIFICATION`
* `RECEIVER_APPOINTED`
* `VOLUNTARY_ARRANGEMENT`
* `CHANGED_COMPANY_TYPE`
* `DE_REGISTERED`
entityType can be either `LEGAL_PERSON` or `NATURAL_PERSON`
| Code | Description |
| -------- | ---------------------------------------------------------------------------------- |
| AGRICO | agricultural company |
| AUMUCO | autonomous municipal company |
| AUPRCO | autonomous provincial company |
| BRUSCR | brussels-capital region authorities |
| CITIES | cities and municipalities |
| CSUNCS | civil society as an unlimited liability and united cs |
| CSCOLS | civil society in the form of a collective society |
| CSLPS | civil society in the form of a limit partnership with shares |
| CSLLCS | civil society in the form of a limited liability cs |
| CSLPAR | civil society in the form of a limited partnership |
| CSPLLC | civil society in the form of a private limited liability company |
| CSPLCO | civil society in the form of a public limited company |
| CSAGCO | civil society in the form of an agricultural company |
| COOWN | co-ownership association |
| COMLCO | common law company |
| COFORM | company in formation |
| CAWOLP | company or association without legal personality |
| CONCOM | congolese company |
| CSOR | cooperative society (old regime) |
| CSPLOR | cooperative society governed by public law (old regime) |
| CSPL | cooperative society governed by public law |
| CSLLPS | cooperative society with limited liability (profit share) |
| CSLLSO | cooperative society with limited liability and a social objective |
| CSLLPP | cooperative society with limited liability governed by public law (profit share) |
| CSLLPL | cooperative society with limited liability governed by public law |
| CSLL | cooperative society with limited liability |
| CSULPS | cooperative society with unlimited liability (profit share) |
| CSULSO | cooperative society with unlimited liability and a social objective |
| CSULPP | cooperative society with unlimited liability governed by public law (profit share) |
| CSULPL | cooperative society with unlimited liability governed by public law |
| CSUL | cooperative society with unlimited liability |
| CS | cooperative society |
| CPASAS | cpas / ocmw association |
| CULT | cult |
| ECASBE | econ. assoc wo regist. seat but with est. unit in belgium |
| EIGSO | economic interest grouping with a social objective |
| EIG | economic interest grouping with registered seat in belgium |
| EEAWOH | europ. econ. assoc wo reg.seat but with est. unit in belgium |
| SE | european company (societas europaea) |
| SCE | european cooperative society |
| EEABE | european economic assoc with registered seat in belgium |
| EUPOLF | european political foundation |
| EUPOLP | european political party |
| EXPASS | expense association |
| FPPS | federal public planning service |
| FPS | federal public service |
| FLEMRC | flemish region and flemish community authorities |
| FLEMRC | flemish region and flemish community authority |
| FEPBE | foreign ent. with property in belgium (without legal pers.) |
| FEPIBLP | foreign entity with property in belgium (with legal personality) |
| FEWOUVAT | foreign entity without belgian establishment unit with vat representation |
| FORENT | foreign entity |
| FCOWHE | foreign listed company without belgian establishment unit |
| FPUORG | foreign or international public organisations |
| FRENCH | french community authorities |
| GPSO | general partnership with a social objective |
| GENPAR | general partnership |
| GERMAN | german-speaking community authorities |
| HEALTH | health fund / mutual health insurance / national union of health funds |
| HULPVZ | hulpverleningszone |
| INTERC | intercommunal |
| INTCO | internal company |
| INPASSPL | international non-profit association governed by public law |
| INPASS | international non-profit association |
| ISCORG | international scientific organisation under belgian law |
| LPPL | limited partnership governed by public law |
| LTDPRTN | limited partnership |
| LOCPOL | local police |
| MINMC | ministry for middle class |
| MINAGR | ministry of agriculture |
| MINECO | ministry of economic affairs |
| MINEMP | ministry of employment and labour |
| MINFIN | ministry of finance |
| MINFOR | ministry of foreign affairs |
| MINHAF | ministry of home affairs |
| MINJUS | ministry of justice |
| MINDEF | ministry of national defence |
| MINEDU | ministry of national education and culture |
| MINHEA | ministry of public health and family |
| MINSER | ministry of public service |
| MINRW | ministry of road works |
| MINSEA | ministry of self-employed and agriculture |
| MINSAH | ministry of social affair public health and environment |
| MINSWF | ministry of social welfare |
| MINBCR | ministry of the brussels-capital region |
| MINFLC | ministry of the flemish community |
| MINFRC | ministry of the french community |
| MINGSC | ministry of the german-speaking community |
| MINWAR | ministry of the walloon region |
| MINTIN | ministry of traffic and infrastructure |
| MIWOLP | miscellaneous without legal personality |
| MISC | miscellaneous |
| NPROFI | non-profit institution |
| NPROF | non-profit organisation |
| LTDPSO | ordinary limited partnership with a social objective |
| OLP | ordinary limited partnership |
| ORGPUP | organis. regist. with the public admin. pensions (finance) |
| NSSOLR | organisations registered through the onssapl |
| ORGONP | organisations registered with the o.n.p |
| OTHFS | other federal services |
| OTHISO | other institution with a social objective (public) |
| OTHER | other legal form |
| OTHPRI | other private organisation with legal personality |
| LTPSSO | partnership limited by shares with a social objective |
| PLTDSH | partnership limited by shares |
| PAWN | pawnshop |
| PENSIO | pension scheme organisation |
| POLDER | polders and water boards |
| PREZON | prezone |
| PFA | private foreign association with establishment in belgium |
| PFA | private foreign association with establishment unit |
| PFA | private foreign association with establishmen agenc office or branch in belgium |
| PRIVFO | private foundation |
| PLCPL | private limited company governed by public law |
| PLC | private limited company |
| PRLCSO | private limited liability company with a social objective |
| PLIMLC | private limited liability company |
| MUTINS | private mutual insurance fund |
| PROFCO | professional corporations - orders |
| PROFUN | professional union |
| PROJAS | project association |
| PROVAU | provincial authorities |
| PROVAU | provincial authority |
| PSOACT | pubic social action centre |
| PUBINS | public institution |
| PLCSO | public limited company with a social objective |
| PLIMCO | public limited company |
| MUTINS | public mutual insurance fund |
| PNPASS | public non-profit association |
| PUBLUF | public utility foundation |
| PUBLUT | public utility institution |
| REPRAS | representative association (flemish region) |
| SEPRAS | service provider association (flemish region) |
| SPRC | stat provinc regio community |
| TEMPAS | temporary association |
| TEMPCO | temporary company |
| SPRMIN | the services of the prime minister |
| TUNION | trade union |
| ULPCSO | unipersonal private limited liability company with a social objective |
| UNNSSO | unkown legal form (nsso) |
| UNLCC | unlawful commercial company |
| VATGR | vat-group |
| WALLRA | walloon region authorities |
| EMZ | sole proprietorship |
| Code | Description |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Organisme de placement collectif en valeurs mobilières sans personnalité morale |
| 1000 | Entrepreneur individuel |
| 2110 | Indivision entre personnes physiques |
| 2120 | Indivision avec personne morale |
| 2210 | Société créée de fait entre personnes physiques |
| 2220 | Société créée de fait avec personne morale |
| 2310 | Société en participation entre personnes physiques |
| 2320 | Société en participation avec personne morale |
| 2385 | Société en participation de professions libérales |
| 2400 | Fiducie |
| 2700 | Paroisse hors zone concordataire |
| 2800 | Assujetti unique à la TVA |
| 2900 | Autre groupement de droit privé non doté de la personnalité morale |
| 3110 | Représentation ou agence commerciale d'état ou organisme public étranger immatriculé au RCS |
| 3120 | Société commerciale étrangère immatriculée au RCS |
| 3205 | Organisation internationale |
| 3210 | État, collectivité ou établissement public étranger |
| 3220 | Société étrangère non immatriculée au RCS |
| 3290 | Autre personne morale de droit étranger |
| 4110 | Établissement public national à caractère industriel ou commercial doté d'un comptable public |
| 4120 | Établissement public national à caractère industriel ou commercial non doté d'un comptable public |
| 4130 | Exploitant public |
| 4140 | Établissement public local à caractère industriel ou commercial |
| 4150 | Régie d'une collectivité locale à caractère industriel ou commercial |
| 4160 | Institution Banque de France |
| 5191 | Société de caution mutuelle |
| 5192 | Société coopérative de banque populaire |
| 5193 | Caisse de crédit maritime mutuel |
| 5194 | Caisse (fédérale) de crédit mutuel |
| 5195 | Association coopérative inscrite (droit local Alsace Moselle) |
| 5196 | Caisse d'épargne et de prévoyance à forme coopérative |
| 5202 | Société en nom collectif |
| 5203 | Société en nom collectif coopérative |
| 5306 | Société en commandite simple |
| 5307 | Société en commandite simple coopérative |
| 5308 | Société en commandite par actions |
| 5309 | Société en commandite par actions coopérative |
| 5310 | Société en libre partenariat (SLP) |
| 5370 | Société de Participations Financières de Profession Libérale Société en commandite par actions (SPFPL SCA) |
| 5385 | Société d'exercice libéral en commandite par actions |
| 5410 | SARL nationale |
| 5415 | SARL d'économie mixte |
| 5422 | SARL immobilière pour le commerce et l'industrie (SICOMI) |
| 5426 | SARL immobilière de gestion |
| 5430 | SARL d'aménagement foncier et d'équipement rural (SAFER) |
| 5431 | SARL mixte d'intérêt agricole (SMIA) |
| 5432 | SARL d'intérêt collectif agricole (SICA) |
| 5442 | SARL d'attribution |
| 5443 | SARL coopérative de construction |
| 5451 | SARL coopérative de consommation |
| 5453 | SARL coopérative artisanale |
| 5454 | SARL coopérative d'intérêt maritime |
| 5455 | SARL coopérative de transport |
| 5458 | SARL coopérative de production (SCOP) |
| 5459 | SARL union de sociétés coopératives |
| 5460 | Autre SARL coopérative |
| 5470 | Société de Participations Financières de Profession Libérale Société à responsabilité limitée (SPFPL SARL) |
| 5485 | Société d'exercice libéral à responsabilité limitée |
| 5499 | Société à responsabilité limitée (sans autre indication) |
| 5505 | SA à participation ouvrière à conseil d'administration |
| 5510 | SA nationale à conseil d'administration |
| 5515 | SA d'économie mixte à conseil d'administration |
| 5520 | Fonds à forme sociétale à conseil d'administration |
| 5522 | SA immobilière pour le commerce et l'industrie (SICOMI) à conseil d'administration |
| 5525 | SA immobilière d'investissement à conseil d'administration |
| 5530 | SA d'aménagement foncier et d'équipement rural (SAFER) à conseil d'administration |
| 5531 | Société anonyme mixte d'intérêt agricole (SMIA) à conseil d'administration |
| 5532 | SA d'intérêt collectif agricole (SICA) à conseil d'administration |
| 5542 | SA d'attribution à conseil d'administration |
| 5543 | SA coopérative de construction à conseil d'administration |
| 5546 | SA de HLM à conseil d'administration |
| 5547 | SA coopérative de production de HLM à conseil d'administration |
| 5548 | SA de crédit immobilier à conseil d'administration |
| 5551 | SA coopérative de consommation à conseil d'administration |
| 5552 | SA coopérative de commerçants-détaillants à conseil d'administration |
| 5553 | SA coopérative artisanale à conseil d'administration |
| 5554 | SA coopérative (d'intérêt) maritime à conseil d'administration |
| 5555 | SA coopérative de transport à conseil d'administration |
| 5558 | SA coopérative de production (SCOP) à conseil d'administration |
| 5559 | SA union de sociétés coopératives à conseil d'administration |
| 5560 | Autre SA coopérative à conseil d'administration |
| 5570 | Société de Participations Financières de Profession Libérale Société anonyme à conseil d'administration (SPFPL SA à conseil d'administration) |
| 5585 | Société d'exercice libéral à forme anonyme à conseil d'administration |
| 5599 | SA à conseil d'administration (s.a.i.) |
| 5605 | SA à participation ouvrière à directoire |
| 5610 | SA nationale à directoire |
| 5615 | SA d'économie mixte à directoire |
| 5620 | Fonds à forme sociétale à directoire |
| 5622 | SA immobilière pour le commerce et l'industrie (SICOMI) à directoire |
| 5625 | SA immobilière d'investissement à directoire |
| 5630 | Safer anonyme à directoire |
| 5631 | SA mixte d'intérêt agricole (SMIA) |
| 5632 | SA d'intérêt collectif agricole (SICA) |
| 5642 | SA d'attribution à directoire |
| 5643 | SA coopérative de construction à directoire |
| 5646 | SA de HLM à directoire |
| 5647 | Société coopérative de production de HLM anonyme à directoire |
| 5648 | SA de crédit immobilier à directoire |
| 5651 | SA coopérative de consommation à directoire |
| 5652 | SA coopérative de commerçants-détaillants à directoire |
| 5653 | SA coopérative artisanale à directoire |
| 5654 | SA coopérative d'intérêt maritime à directoire |
| 5655 | SA coopérative de transport à directoire |
| 5658 | SA coopérative de production (SCOP) à directoire |
| 5659 | SA union de sociétés coopératives à directoire |
| 5660 | Autre SA coopérative à directoire |
| 5670 | Société de Participations Financières de Profession Libérale Société anonyme à Directoire (SPFPL SA à directoire) |
| 5685 | Société d'exercice libéral à forme anonyme à directoire |
| 5699 | SA à directoire (s.a.i.) |
| 5710 | SAS, société par actions simplifiée |
| 5770 | Société de Participations Financières de Profession Libérale Société par actions simplifiée (SPFPL SAS) |
| 5785 | Société d'exercice libéral par action simplifiée |
| 5800 | Société européenne |
| 6100 | Caisse d'Épargne et de Prévoyance |
| 6210 | Groupement européen d'intérêt économique (GEIE) |
| 6220 | Groupement d'intérêt économique (GIE) |
| 6316 | Coopérative d'utilisation de matériel agricole en commun (CUMA) |
| 6317 | Société coopérative agricole |
| 6318 | Union de sociétés coopératives agricoles |
| 6411 | Société d'assurance à forme mutuelle |
| 6511 | Sociétés Interprofessionnelles de Soins Ambulatoires |
| 6521 | Société civile de placement collectif immobilier (SCPI) |
| 6532 | Société civile d'intérêt collectif agricole (SICA) |
| 6533 | Groupement agricole d'exploitation en commun (GAEC) |
| 6534 | Groupement foncier agricole |
| 6535 | Groupement agricole foncier |
| 6536 | Groupement forestier |
| 6537 | Groupement pastoral |
| 6538 | Groupement foncier et rural |
| 6539 | Société civile foncière |
| 6540 | Société civile immobilière |
| 6541 | Société civile immobilière de construction-vente |
| 6542 | Société civile d'attribution |
| 6543 | Société civile coopérative de construction |
| 6544 | Société civile immobilière d' accession progressive à la propriété |
| 6551 | Société civile coopérative de consommation |
| 6554 | Société civile coopérative d'intérêt maritime |
| 6558 | Société civile coopérative entre médecins |
| 6560 | Autre société civile coopérative |
| 6561 | SCP d'avocats |
| 6562 | SCP d'avocats aux conseils |
| 6563 | SCP d'avoués d'appel |
| 6564 | SCP d'huissiers |
| 6565 | SCP de notaires |
| 6566 | SCP de commissaires-priseurs |
| 6567 | SCP de greffiers de tribunal de commerce |
| 6568 | SCP de conseils juridiques |
| 6569 | SCP de commissaires aux comptes |
| 6571 | SCP de médecins |
| 6572 | SCP de dentistes |
| 6573 | SCP d'infirmiers |
| 6574 | SCP de masseurs-kinésithérapeutes |
| 6575 | SCP de directeurs de laboratoire d'analyse médicale |
| 6576 | SCP de vétérinaires |
| 6577 | SCP de géomètres experts |
| 6578 | SCP d'architectes |
| 6585 | Autre société civile professionnelle |
| 6589 | Société civile de moyens |
| 6595 | Caisse locale de crédit mutuel |
| 6596 | Caisse de crédit agricole mutuel |
| 6597 | Société civile d'exploitation agricole |
| 6598 | Exploitation agricole à responsabilité limitée |
| 6599 | Autre société civile |
| 6901 | Autre personne de droit privé inscrite au registre du commerce et des sociétés |
| 7111 | Autorité constitutionnelle |
| 7112 | Autorité administrative ou publique indépendante |
| 7113 | Ministère |
| 7120 | Service central d'un ministère |
| 7150 | Service du ministère de la Défense |
| 7160 | Service déconcentré à compétence nationale d'un ministère (hors Défense) |
| 7171 | Service déconcentré de l'État à compétence (inter) régionale |
| 7172 | Service déconcentré de l'État à compétence (inter) départementale |
| 7179 | (Autre) Service déconcentré de l'État à compétence territoriale |
| 7190 | Ecole nationale non dotée de la personnalité morale |
| 7210 | Commune et commune nouvelle |
| 7220 | Département |
| 7225 | Collectivité et territoire d'Outre Mer |
| 7229 | (Autre) Collectivité territoriale |
| 7230 | Région |
| 7312 | Commune associée et commune déléguée |
| 7313 | Section de commune |
| 7314 | Ensemble urbain |
| 7321 | Association syndicale autorisée |
| 7322 | Association foncière urbaine |
| 7323 | Association foncière de remembrement |
| 7331 | Établissement public local d'enseignement |
| 7340 | Pôle métropolitain |
| 7341 | Secteur de commune |
| 7342 | District urbain |
| 7343 | Communauté urbaine |
| 7344 | Métropole |
| 7345 | Syndicat intercommunal à vocation multiple (SIVOM) |
| 7346 | Communauté de communes |
| 7347 | Communauté de villes |
| 7348 | Communauté d'agglomération |
| 7349 | Autre établissement public local de coopération non spécialisé ou entente |
| 7351 | Institution interdépartementale ou entente |
| 7352 | Institution interrégionale ou entente |
| 7353 | Syndicat intercommunal à vocation unique (SIVU) |
| 7354 | Syndicat mixte fermé |
| 7355 | Syndicat mixte ouvert |
| 7356 | Commission syndicale pour la gestion des biens indivis des communes |
| 7357 | Pôle d'équilibre territorial et rural (PETR) |
| 7361 | Centre communal d'action sociale |
| 7362 | Caisse des écoles |
| 7363 | Caisse de crédit municipal |
| 7364 | Établissement d'hospitalisation |
| 7365 | Syndicat inter hospitalier |
| 7366 | Établissement public local social et médico-social |
| 7367 | Centre Intercommunal d'action sociale (CIAS) |
| 7371 | Office public d'habitation à loyer modéré (OPHLM) |
| 7372 | Service départemental d'incendie et de secours (SDIS) |
| 7373 | Établissement public local culturel |
| 7378 | Régie d'une collectivité locale à caractère administratif |
| 7379 | (Autre) Établissement public administratif local |
| 7381 | Organisme consulaire |
| 7382 | Établissement public national ayant fonction d'administration centrale |
| 7383 | Établissement public national à caractère scientifique culturel et professionnel |
| 7384 | Autre établissement public national d'enseignement |
| 7385 | Autre établissement public national administratif à compétence territoriale limitée |
| 7389 | Établissement public national à caractère administratif |
| 7410 | Groupement d'intérêt public (GIP) |
| 7430 | Établissement public des cultes d'Alsace-Lorraine |
| 7450 | Etablissement public administratif, cercle et foyer dans les armées |
| 7470 | Groupement de coopération sanitaire à gestion publique |
| 7490 | Autre personne morale de droit administratif |
| 8110 | Régime général de la Sécurité Sociale |
| 8120 | Régime spécial de Sécurité Sociale |
| 8130 | Institution de retraite complémentaire |
| 8140 | Mutualité sociale agricole |
| 8150 | Régime maladie des non-salariés non agricoles |
| 8160 | Régime vieillesse ne dépendant pas du régime général de la Sécurité Sociale |
| 8170 | Régime d'assurance chômage |
| 8190 | Autre régime de prévoyance sociale |
| 8210 | Mutuelle |
| 8250 | Assurance mutuelle agricole |
| 8290 | Autre organisme mutualiste |
| 8310 | Comité social économique d’entreprise |
| 8311 | Comité social économique d'établissement |
| 8410 | Syndicat de salariés |
| 8420 | Syndicat patronal |
| 8450 | Ordre professionnel ou assimilé |
| 8470 | Centre technique industriel ou comité professionnel du développement économique |
| 8490 | Autre organisme professionnel |
| 8510 | Institution de prévoyance |
| 8520 | Institution de retraite supplémentaire |
| 9110 | Syndicat de copropriété |
| 9150 | Association syndicale libre |
| 9210 | Association non déclarée |
| 9220 | Association déclarée |
| 9221 | Association déclarée d'insertion par l'économique |
| 9222 | Association intermédiaire |
| 9223 | Groupement d'employeurs |
| 9224 | Association d'avocats à responsabilité professionnelle individuelle |
| 9230 | Association déclarée, reconnue d'utilité publique |
| 9240 | Congrégation |
| 9260 | Association de droit local (Bas-Rhin, Haut-Rhin et Moselle) |
| 9300 | Fondation |
| 9900 | Autre personne morale de droit privé |
| 9970 | Groupement de coopération sanitaire à gestion privée |
| Code | Description |
| ---- | -------------------------------------------------------- |
| BV | Besloten Vennootschap |
| VVE | Vereniging van Eigenaars |
| VOF | Vennootschap Onder firma |
| VER | Vereniging |
| ST | Stichting |
| COP | Coöperatie |
| KG | Kerkgenootschap |
| CV | Commanditaire Vennootschap |
| MA | Maatschap |
| NV | Naamloze Vennootschap |
| BR | Buitenlandse Rechtsvorm |
| OWM | Onderlinge Waarborg Maatschappij |
| RIO | Rechtsperoon in oprichting |
| RIO | Rechtspersoon in oprichting |
| PR | Publiekrechtelijke Rechtspersoon |
| SE | Europese naamloze vennootschap (SE) |
| OPR | Overige Privaatrechtelijke Rechtspersoon |
| EESV | Europees economisch samenwerkingsverband |
| EMZ | Eenmanszaak |
| SE | Europese naamloze vennootschap (SE) met gewone structuur |
| RED | Rederij |
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
Common score is a score provided by CreditSafe that predicts the likelihood of a company becoming insolvent or bankrupt within the next 12 months
| Score | Description |
| ----- | -------------- |
| A | Very low risk |
| B | Low risk |
| C | Moderate risk |
| D | High risk |
| E | Very high risk |
This is the credit limit provided by CreditSafe. It is the recommended maximum amount of credit that can be safely extended to a company at one time.
The email address of the company
The international phone number of the company
'Do Not Call Me' flag
```json Response - 200 theme={null}
[
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy AI",
"place": "Gent"
},
"data": {
"vatNumber": "BE0770.493.071",
"status": "ACTIVE",
"legalStatus": "NORMAL_SITUATION",
"description": "Bizzy is a B2B intelligence platform that uses AI and machine learning to provide sales professionals, marketers, and investors with real-time insights and data on companies. Their solution helps users discover, qualify, and engage with companies more efficiently, allowing them to focus on the right leads and opportunities.",
"logo": "https://bizzy.ams3.digitaloceanspaces.com/prod/companies/be/logos/fa6fd26d-f23a-416a-822e-624a0eca6e3b/100075701964481.png",
"establishedSince": "2021-06-29T00:00:00.000Z",
"stoppedSince": null,
"entityType": "LEGAL_PERSON",
"companyTypeCode": "PLC",
"name": "Bizzy AI",
"tradeNames": [
{
"name": "Bizzy AI"
},
{
"name": "Bizzy"
}
],
"address": {
"country": "BE",
"street": "Dok-Noord",
"number": "4E",
"box": "//4",
"postalCode": "9000",
"place": "Gent"
},
"website": [
"https://bizzy.ai"
],
"socials": {
"x": "https://twitter.com/bizzyinsights",
"facebook": "https://www.facebook.com/bizzyinsights",
"youtube": null,
"instagram": "https://www.instagram.com/bizzyinsights/",
"linkedin": "https://www.linkedin.com/company/bizzyinsights/"
},
"contact": {
"email": "hello@bizzy.ai",
"phone": null
},
"naceCodes": [
{
"code": "62010"
},
{
"code": "62020"
},
{
"code": "62090"
},
{
"code": "70220"
}
],
"activities": [
{
"activity": "BUSINESS_CONSULTING"
},
{
"activity": "DATA_ANALYTICS"
}
],
"revenueEstimations": "Bucket0_1M",
"employeeEstimations": "Bucket10_19",
"commonScore": "C",
"creditLimit": 500
},
"message": null
},
{
"identifier": { // Example error
"country": "BE",
"companyNumber": "123",
},
"data": null,
"message": "Company not found"
}
]
```
# Financials
Source: https://docs.bizzy.ai/api-reference/v1/company/financials
GET /v1/companies/{countryCode}/{companyNumber}/financials
## Request
#### Header
* NL: Dutch
* FR: French
* EN: English
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
#### Query
Number of items to return per page. (max 500)
Number of items to skip
```json Response - 200 theme={null}
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": [
{
"startDate": "2023-01-01",
"endDate": "2023-12-31",
"dateReceived": "2024-07-31",
"healthIndicator": 5,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": -157493.98,
"ebitda": -721635.55,
"ebit": -909762.24,
"netProfit": -924861.06
},
"liquidity": {
"cash": 486301.02,
"cashFlow": -736314.45,
"netWorkingCapital": 13795.96,
"netWorkingCapitalRequirement": -454370.47,
"currentRatio": 1.0196,
"quickRatio": 1.6408
},
"solvency": {
"totalAssets": 1198129.04,
"equity": 115032.76,
"capital": null,
"retainedEarnings": -1208423.24,
"debt": 1083096.28,
"longTermDebt": 379351.41,
"longTermDebtFinancial": 379351.41,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 404044.38,
"shortTermDebtFinancial": 18134.59,
"shortTermDebtAccountsPayable": 158076.92
},
"people": {
"employees": 12,
"newHires": 6,
"employeeMaleRatio": 0.9167,
"employeeFemaleRatio": 0.0833
}
},
{
"startDate": "2021-06-29",
"endDate": "2022-12-31",
"dateReceived": "2023-07-31",
"healthIndicator": 7,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": 165086.63,
"ebitda": -186249.28,
"ebit": -280667.61,
"netProfit": -283562.18
},
"liquidity": {
"cash": 737378.68,
"cashFlow": -188584.41,
"netWorkingCapital": 597619.72,
"netWorkingCapitalRequirement": -133652.28,
"currentRatio": 4.4686,
"quickRatio": 4.4961
},
"solvency": {
"totalAssets": 1098395.25,
"equity": 878893.82,
"capital": null,
"retainedEarnings": -283562.18,
"debt": 219501.43,
"longTermDebt": 47209.12,
"longTermDebtFinancial": 47209.12,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 168577.31,
"shortTermDebtFinancial": 6106.68,
"shortTermDebtAccountsPayable": 44652.51
},
"people": {
"employees": 6,
"newHires": 15,
"employeeMaleRatio": 0.8333,
"employeeFemaleRatio": 0.1667
}
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
}
}
```
# Bulk Financials
Source: https://docs.bizzy.ai/api-reference/v1/company/financialsBulk
POST /v1/companies/financials
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
You can request up to 100 companies at once.
Number of items to return per page. (max 500)
Number of items to skip.
```json Response - 200 theme={null}
[
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": [
{
"startDate": "2023-01-01",
"endDate": "2023-12-31",
"dateReceived": "2024-07-31",
"healthIndicator": 5,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": -157493.98,
"ebitda": -721635.55,
"ebit": -909762.24,
"netProfit": -924861.06
},
"liquidity": {
"cash": 486301.02,
"cashFlow": -736314.45,
"netWorkingCapital": 13795.96,
"netWorkingCapitalRequirement": -454370.47,
"currentRatio": 1.0196,
"quickRatio": 1.6408
},
"solvency": {
"totalAssets": 1198129.04,
"equity": 115032.76,
"capital": null,
"retainedEarnings": -1208423.24,
"debt": 1083096.28,
"longTermDebt": 379351.41,
"longTermDebtFinancial": 379351.41,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 404044.38,
"shortTermDebtFinancial": 18134.59,
"shortTermDebtAccountsPayable": 158076.92
},
"people": {
"employees": 12,
"newHires": 6,
"employeeMaleRatio": 0.9167,
"employeeFemaleRatio": 0.0833
}
},
{
"startDate": "2021-06-29",
"endDate": "2022-12-31",
"dateReceived": "2023-07-31",
"healthIndicator": 7,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": 165086.63,
"ebitda": -186249.28,
"ebit": -280667.61,
"netProfit": -283562.18
},
"liquidity": {
"cash": 737378.68,
"cashFlow": -188584.41,
"netWorkingCapital": 597619.72,
"netWorkingCapitalRequirement": -133652.28,
"currentRatio": 4.4686,
"quickRatio": 4.4961
},
"solvency": {
"totalAssets": 1098395.25,
"equity": 878893.82,
"capital": null,
"retainedEarnings": -283562.18,
"debt": 219501.43,
"longTermDebt": 47209.12,
"longTermDebtFinancial": 47209.12,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 168577.31,
"shortTermDebtFinancial": 6106.68,
"shortTermDebtAccountsPayable": 44652.51
},
"people": {
"employees": 6,
"newHires": 15,
"employeeMaleRatio": 0.8333,
"employeeFemaleRatio": 0.1667
}
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
},
"message": null
}
{
"identifier": { // Example error
"country": "BE",
"companyNumber": "123",
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v1/company/introduction
**API v1 is deprecated and will no longer be supported after 15 November 2026.** Please migrate to [API v2](/api-reference/v2/company/introduction) before then. Questions? Contact [support@bizzy.ai](mailto:support@bizzy.ai).
With our Companies API, you can fetch details of all companies in our database.
Depending on the used endpoint, we'll return a specific payload.
The basic endpoint is the *'details'*, while all others can be seen as extensions.
## Company identifiers
All company endpoint URLs must contain the country and unique identifier of the required company *(../BE/0770493071/...)*.
This identifier is depending on the official registration country of the company.
The identifiers for the supported countries are the following:
* **Belgium**: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* **The Netherlands**: KVK number
* **France**: SIREN number
# Lookalikes
Source: https://docs.bizzy.ai/api-reference/v1/company/lookalikes
GET /v1/companies/{countryCode}/{companyNumber}/lookalikes
## Request
#### Header
* NL: Dutch
* FR: French
* EN: English
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
```json Response - 200 theme={null}
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": [
{
"companyId": {
"country": "BE",
"companyNumber": "568854619"
},
"score": 0.8994202558671441
},
{
"companyId": {
"country": "BE",
"companyNumber": "746718173"
},
"score": 0.8795804344229533
},
{
"companyId": {
"country": "BE",
"companyNumber": "884349691"
},
"score": 0.8745580099535469
},
{
"companyId": {
"country": "BE",
"companyNumber": "799722339"
},
"score": 0.8694082018380358
},
{
"companyId": {
"country": "BE",
"companyNumber": "764725729"
},
"score": 0.8668790698956205
},
{
"companyId": {
"country": "BE",
"companyNumber": "473804022"
},
"score": 0.8662065908652262
},
{
"companyId": {
"country": "BE",
"companyNumber": "786634465"
},
"score": 0.8654307217191164
},
{
"companyId": {
"country": "BE",
"companyNumber": "669639795"
},
"score": 0.8644006390920925
},
{
"companyId": {
"country": "BE",
"companyNumber": "759375188"
},
"score": 0.862910468060966
},
{
"companyId": {
"country": "BE",
"companyNumber": "893712567"
},
"score": 0.8626535515796075
},
{
"companyId": {
"country": "BE",
"companyNumber": "810673045"
},
"score": 0.8621558094560501
},
{
"companyId": {
"country": "BE",
"companyNumber": "463769668"
},
"score": 0.861936273931794
},
{
"companyId": {
"country": "BE",
"companyNumber": "728898481"
},
"score": 0.860111455665143
},
{
"companyId": {
"country": "BE",
"companyNumber": "782425952"
},
"score": 0.8600602271234766
},
{
"companyId": {
"country": "BE",
"companyNumber": "881854912"
},
"score": 0.8599600365002186
},
{
"companyId": {
"country": "BE",
"companyNumber": "453604761"
},
"score": 0.8594808004589513
},
{
"companyId": {
"country": "BE",
"companyNumber": "757787952"
},
"score": 0.8584194316406126
},
{
"companyId": {
"country": "BE",
"companyNumber": "785381581"
},
"score": 0.8583027871329801
},
{
"companyId": {
"country": "BE",
"companyNumber": "864486467"
},
"score": 0.8579399864322313
},
{
"companyId": {
"country": "BE",
"companyNumber": "671933846"
},
"score": 0.7562784824257733
}
]
}
```
# Bulk Lookalikes
Source: https://docs.bizzy.ai/api-reference/v1/company/lookalikesBulk
POST /v1/companies/lookalikes
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
You can request up to 100 companies at once.
```json Response - 200 theme={null}
[
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": [
{
"companyId": {
"country": "BE",
"companyNumber": "568854619"
},
"score": 0.8994202558671441
},
{
"companyId": {
"country": "BE",
"companyNumber": "746718173"
},
"score": 0.8795804344229533
},
{
"companyId": {
"country": "BE",
"companyNumber": "884349691"
},
"score": 0.8745580099535469
},
{
"companyId": {
"country": "BE",
"companyNumber": "799722339"
},
"score": 0.8694082018380358
},
{
"companyId": {
"country": "BE",
"companyNumber": "764725729"
},
"score": 0.8668790698956205
},
{
"companyId": {
"country": "BE",
"companyNumber": "473804022"
},
"score": 0.8662065908652262
},
{
"companyId": {
"country": "BE",
"companyNumber": "786634465"
},
"score": 0.8654307217191164
},
{
"companyId": {
"country": "BE",
"companyNumber": "669639795"
},
"score": 0.8644006390920925
},
{
"companyId": {
"country": "BE",
"companyNumber": "759375188"
},
"score": 0.862910468060966
},
{
"companyId": {
"country": "BE",
"companyNumber": "893712567"
},
"score": 0.8626535515796075
},
{
"companyId": {
"country": "BE",
"companyNumber": "810673045"
},
"score": 0.8621558094560501
},
{
"companyId": {
"country": "BE",
"companyNumber": "463769668"
},
"score": 0.861936273931794
},
{
"companyId": {
"country": "BE",
"companyNumber": "728898481"
},
"score": 0.860111455665143
},
{
"companyId": {
"country": "BE",
"companyNumber": "782425952"
},
"score": 0.8600602271234766
},
{
"companyId": {
"country": "BE",
"companyNumber": "881854912"
},
"score": 0.8599600365002186
},
{
"companyId": {
"country": "BE",
"companyNumber": "453604761"
},
"score": 0.8594808004589513
},
{
"companyId": {
"country": "BE",
"companyNumber": "757787952"
},
"score": 0.8584194316406126
},
{
"companyId": {
"country": "BE",
"companyNumber": "785381581"
},
"score": 0.8583027871329801
},
{
"companyId": {
"country": "BE",
"companyNumber": "864486467"
},
"score": 0.8579399864322313
},
{
"companyId": {
"country": "BE",
"companyNumber": "671933846"
},
"score": 0.7562784824257733
}
],
"message": null
},
{
"identifier": { // Example error
"country": "BE",
"companyNumber": "123",
},
"data": null,
"message": "Company not found"
}
]
```
# Relationships
Source: https://docs.bizzy.ai/api-reference/v1/company/relationships
GET /v1/companies/{countryCode}/{companyNumber}/relationships
## Request
#### Header
* NL: Dutch
* FR: French
* EN: English
#### Path
countryCode can be either `BE`, `NL` or `FR`
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
```json Response - 200 theme={null}
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": {
"parents": [
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.15,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.012,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.1171,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.0157,
"name": "Bizzy Fintech"
},
{
"identifier": null
}
],
"children": []
}
}
```
# Bulk Relationships
Source: https://docs.bizzy.ai/api-reference/v1/company/relationshipsBulk
POST /v1/companies/relationships
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
You can request up to 100 companies at once.
```json Response - 200 theme={null}
[
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"data": {
"parents": [
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.15,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.012,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.1171,
"name": "Bizzy Fintech"
},
{
"identifier": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "Gent"
},
"function": "SHAREHOLDER",
"percentage": 0.0157,
"name": "Bizzy Fintech"
},
{
"identifier": null
}
],
"children": []
},
"message": null
},
{
"identifier": { // Example error
"country": "BE",
"companyNumber": "123"
},
"data": null,
"message": "Company not found"
}
]
```
# Search
Source: https://docs.bizzy.ai/api-reference/v1/company/search
GET /v1/companies?q={q}
## Request
#### Query
The name of the company you want to query, up to 20 characters
countryCode can be either `BE`, `NL` or `FR`, if ommited it will do a search across the 3 countries.
```json Response - 200 theme={null}
[
{
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy Fintech",
"place": "9000"
}
]
```
# Credit usage
Source: https://docs.bizzy.ai/api-reference/v1/credits
# Introduction
A credit will be charged when fetching a company for the first time. You'll then be able to get all company details for free in the next 30 days.
The endpoints for which a credit will be charged the first time you access the company are `Details`, `Financials`, `Relationships`, `Lookalikes`, `Contacts`. All other endpoints are free of use, like `Search` and list endpoints.
## Enriching contacts
You will only be charged for enrichments when data is **available**.
If no data is available, no credits will be charged.
### Emails
A credit will be charged when enriching a contact with an email address.
This is only applicable for the `Contact Details` endpoint.
### Mobile phone numbers
* **2 credits** will be charged when enriching a contact with a mobile phone number, **if the API user does not have a connected Prospeo account**.
* **1 credit** will be charged if the **API user has a connected Prospeo account**.
## Response header
The response header will contain the following fields:
* `X-Bizzy-Credits-Balance`: Your remaining credit balance
* `X-Bizzy-Credits-Charged`: The number of credits charged for this request
# Error handling
Source: https://docs.bizzy.ai/api-reference/v1/errors
## Available error codes
| Status | Description |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400 | Bad request. The request or the request body is invalid. Examples: missing required fields, invalid field format. |
| 401 | Unauthorized. The request requires authentication. This usually means the API key is missing or invalid. |
| 402 | Insufficient credits. You do not have enough credits to perform this request. See [Credit usage](/api-reference/v1/credits) for more information. |
| 403 | Forbidden. The request is not allowed. This may be due to insufficient privileges or attempting to access resources belonging to another user. |
| 404 | Not found. The requested resource does not exist. This could be due to an incorrect ID or an invalid endpoint. |
| 429 | Too many requests. You have exceeded the rate limit. See [Rate limiting](/api-reference/v1/rateLimiting) for more information. |
| 500 | Internal server error. Something went wrong on our side. If this persists, please contact support with the request details so we can investigate. |
## Error format
All errors are returned as JSON objects with a `status` and optionally a `message` field. The `status` field is one of the HTTP status codes defined above, and the `message` is a human-readable explanation of the error.
```json theme={null}
{
"status": 400,
"message": "Invalid query"
}
```
# Details
Source: https://docs.bizzy.ai/api-reference/v1/export/details
GET /v1/exports/{id}
## Request
#### Path
ID of the export. This is the ID that was returned when you queued the export (see [exports endpoint](../lists/export) in the Lists API).
## Response
ID of the export.
Name of the export.
Status of the export. Can be one of the following:
* `PENDING`: The export is pending and will be processed in the background.
* `IN_PROGRESS`: The export is in progress.
* `AVAILABLE`: The export is available for download.
* `EXPIRED`: The export has expired and is no longer available for download (available for 7 days after completion).
* `FAILED`: The export failed.
* `INSUFFICIENT_CREDITS`: The export failed because the user has insufficient credits.
* `NO_RESULTS`: The export failed because there are no results to export.
Progress of the export. Number between 0 and 1 (2 decimal places).
URL of the export file. Only available when the export status is `AVAILABLE`.
```json Response - 200 theme={null}
{
"id": 1234567890,
"name": "Example Export",
"status": "COMPLETED",
"progress": 1.00,
"url": "https://bizzy.ams3.digitaloceanspaces.com/prod/files/bizzy-example-export.csv"
}
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v1/export/introduction
**API v1 is deprecated and will no longer be supported after 15 November 2026.** Please migrate to [API v2](/api-reference/v2/company/introduction) before then. Questions? Contact [support@bizzy.ai](mailto:support@bizzy.ai).
With our Exports API, you will be able to retrieve the details of an export.
Queueing an export will return an export ID. You can use this ID to retrieve the details of the export.
# Companies
Source: https://docs.bizzy.ai/api-reference/v1/lists/companies
GET /v1/lists/{id}/companies
## Request
#### Query
Smart list type to fetch - type can be either `SAVED`, `ARCHIVED`, `NEW` or `ALL` which will return every company.
Number of items to return per page. (max 500)
Number of items to skip
## Response
The matchedSince is in ISO 8601 date format.
* For **static lists**, this represents the date when the item was added to the list.
* For **smart lists**, this represents the date the item matched the list's filters and was added as a new result.
```json Response - 200 theme={null}
{
"data": [
{
"identifier": {
"country": "BE",
"companyNumber": "441571714",
"name": "TOYOTA MOTOR EUROPE",
"place": "Evere"
},
"matchedSince": "2024-11-20T13:47:43.000Z"
},
{
"identifier": {
"country": "BE",
"companyNumber": "403834160",
"name": "Janssen Pharmaceutica",
"place": "Beerse"
},
"matchedSince": "2024-11-20T13:47:43.000Z"
},
{
"identifier": {
"country": "BE",
"companyNumber": "403170701",
"name": "ELECTRABEL",
"place": "Bruxelles"
},
"matchedSince": "2024-11-20T13:47:43.000Z"
},
{
"identifier": {
"country": "BE",
"companyNumber": "416375270",
"name": "EXXONMOBIL PETROLEUM & CHEMICAL",
"place": "Antwerpen"
},
"matchedSince": "2024-11-20T13:47:43.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 50
}
}
```
# Bulk Companies
Source: https://docs.bizzy.ai/api-reference/v1/lists/companiesBulk
PUT /v1/lists/{id}/companies
This only works for static lists!
The accuracy of the matching process improves with more detailed information. Providing additional parameters can significantly enhance the precision of the results.
## Request
At least one parameter is needed per company!
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
Country can be either `BE`, `NL` or `FR`
Name of the company
Website of the company
VAT of the company
You can add up to 100 companies to a list at once.
```json Response - 200 theme={null}
{
"success": true,
"message": "Successfully added 99 companies to the list",
"failed": [ // Example error
{
"parameters": {
"companyNumber": "123",
},
"message": "Company not found"
}
]
}
```
# Company
Source: https://docs.bizzy.ai/api-reference/v1/lists/company
PUT /v1/lists/{id}/company
This only works for static lists!
The accuracy of the matching process improves with more detailed information. Providing additional parameters can significantly enhance the precision of the results.
## Request
At least one parameter is needed!
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
Country can be either `BE`, `NL` or `FR`
Name of the company
Website of the company
VAT of the company
```json Response - 200 theme={null}
Company added successfully
```
# Contact
Source: https://docs.bizzy.ai/api-reference/v1/lists/contact
PUT /v1/lists/{id}/contact
This only works for static lists!
## Request
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without ‘BE’.
* The Netherlands: KVK number
* France: SIREN number
Country can be either `BE`, `NL` or `FR`
ContactId is the unique identifier of the contact.
```json Response - 200 theme={null}
Contact added successfully
```
# Contacts
Source: https://docs.bizzy.ai/api-reference/v1/lists/contacts
GET /v1/lists/{id}/contacts
## Request
#### Query
Number of items to return per page. (max 500)
Number of items to skip
```json Response - 200 theme={null}
{
"data": [
{
"jobTitle": "Software Engineer",
"identifier": {
"contactId": 1234567890,
"firstName": "John",
"lastName": "Doe"
},
"company": {
"country": "BE",
"companyNumber": "770493071",
"name": "Bizzy AI",
"place": "Gent"
}
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Bulk Contacts
Source: https://docs.bizzy.ai/api-reference/v1/lists/contactsBulk
PUT /v1/lists/{id}/contacts
This only works for static lists!
## Request
#### Body
* Belgium: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* The Netherlands: KVK number.
* France: SIREN number.
countryCode can be either `BE`, `NL` or `FR`
contactId is the unique identifier you get from the contacts endpoint.
You can add up to 50 contacts per company to a list at once.
You can add contacts of up to 100 companies to a list at once.
```json Response - 200 theme={null}
{
"success": true,
"message": "Successfully added 99 contacts to the list",
"failed": [
{
"companyIdentifier": {
"country": "BE",
"companyNumber": "770493071",
},
"contacts": [ // Example error contacts
{
"contactIdentifier": {
"contactId": "123",
},
"message": "Contact not found"
}
],
"message": null
},
{
"companyIdentifier": { // Example error company
"country": "BE",
"companyNumber": "123",
},
"contacts": null,
"message": "Company not found"
}
]
}
```
# Export
Source: https://docs.bizzy.ai/api-reference/v1/lists/export
POST /v1/lists/{id}/export
Use this endpoint to queue an export. The export will be processed in the background and you will be able to download the export file from the [exports endpoint](../export/details) in the Exports API.
## Request
#### Body
Type of export. Can be either `CSV` or `XLSX`.
Columns to export.
* `activities`
* `address`
* `amountOfJobOpenings`
* `amountOfLocations`
* `blueCollarFtes`
* `blueCollarHeadcount`
* `businessModels`
* `capital`
* `capitalGrowth`
* `cash`
* `cashFlow`
* `cashFlowGrowth`
* `cashGrowth`
* `cashRatio`
* `commonScore`
* `companyType`
* `country`
* `countryOfOrigin`
* `creditLimit`
* `currentRatio`
* `debt`
* `debtGrowth`
* `debtRatio`
* `description`
* `distributedProfits`
* `distributedProfitsGrowth`
* `ebit`
* `ebitda`
* `ebitdaGrowth`
* `ebitdaInPercentage`
* `ebitGrowth`
* `ebitInPercentage`
* `email`
* `emailVerified`
* `employeeBucket`
* `employees`
* `equity`
* `equityGrowth`
* `estimatedEmployees`
* `estimatedRevenue`
* `foundingDate`
* `grossMargin`
* `grossMarginGrowth`
* `grossMarginInPercentage`
* `healthIndicator`
* `houseNumber`
* `investmentDeduction`
* `jointCommitteeCode`
* `keywords`
* `legalStatus`
* `locality`
* `longTermDebt`
* `longTermDebtAccountsPayable`
* `longTermDebtAccountsPayableGrowth`
* `longTermDebtFinancial`
* `longTermDebtFinancialGrowth`
* `longTermDebtGrowth`
* `naceCodes`
* `nafCodes`
* `netProfit`
* `netProfitGrowth`
* `netProfitInPercentage`
* `netWorkingCapital`
* `netWorkingCapitalGrowth`
* `netWorkingCapitalRequirement`
* `netWorkingCapitalRequirementGrowth`
* `newHires`
* `parentCompany`
* `phone`
* `phoneVerified`
* `postalCode`
* `province`
* `quickRatio`
* `registrationNumber`
* `retainedEarnings`
* `retainedEarningsGrowth`
* `revenue`
* `revenueBucket`
* `revenueGrowth`
* `sbiCodes`
* `shortTermDebt`
* `shortTermDebtAccountsPayable`
* `shortTermDebtAccountsPayableGrowth`
* `shortTermDebtFinancial`
* `shortTermDebtFinancialGrowth`
* `shortTermDebtGrowth`
* `shortTermDebtRatio`
* `sicCodes`
* `siret`
* `socials`
* `status`
* `stoppedDate`
* `street`
* `technologies`
* `technologyCategories`
* `temporaryWorkersAtClosingDate`
* `temporaryWorkersFTE`
* `temporaryWorkersTotalCost`
* `temporaryWorkersTotalHours`
* `totalAssets`
* `totalAssetsGrowth`
* `totalEmployeeHeadcount`
* `tradeDebtorsMoreOneYear`
* `tradeDebtorsWithinOneYear`
* `url`
* `usedLanguages`
* `vatNumber`
* `whiteCollarFtes`
* `whiteCollarHeadcount`
Maximum number of companies to export.
Companies to include in the export. Can be either `ALL` or `WITH_CONTACT_ONLY`.
Number of contacts per company to include in the export.
Enrichment type for email address. Can be either `ALL`, `RISKY` or `VERIFIED`.
Enrichment type for mobile phone number. Can be either `ALL` or `ONLY_WITH_PHONE`.
```json Response - 200 theme={null}
{
"success": true,
"exportId": "1234567890",
"message": "Export queued successfully"
}
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v1/lists/introduction
**API v1 is deprecated and will no longer be supported after 15 November 2026.** Please migrate to [API v2](/api-reference/v2/company/introduction) before then. Questions? Contact [support@bizzy.ai](mailto:support@bizzy.ai).
The Lists API allows you to retrieve details about your team's lists and their content.
The specific payload returned depends on the endpoint you use.
Fetching lists operates at the organization level.
This means you can access all lists and their contents, even if the lists are **not shared**.
# Overview
Source: https://docs.bizzy.ai/api-reference/v1/lists/overview
GET /v1/lists
## Request
#### Query
List type to fetch - type can be either `STATIC`, `SMART` or `OVERVIEW` which will return both static and smart lists
Number of items to return per page. (max 500)
Number of items to skip
## Response
The following fields can have a set of values:
type can be either `STATIC` or `SMART`
For **smart lists**, it returns a number indicating the count of new results based on the applied filters.
For **static lists**, it is always set to `null`.
Notifications can only be enabled for **static lists** at this time.
```json Response - 200 theme={null}
{
"data": [
{
"id": 1357924680,
"name": "Example List One",
"type": "STATIC",
"columns": [
"activities",
"vatNumber",
"country",
"url",
"socials"
],
"shared": false,
"notifications": {
"enabled": true
},
"amountOfCompanies": 15,
"newResults": null,
"updatedAt": "2024-11-18T10:30:00.000Z",
"createdAt": "2024-10-20T08:45:00.000Z",
"createdBy": "jane.doe@example.com"
},
{
"id": 246813579,
"name": "Shared List",
"type": "SMART",
"columns": [
"description"
],
"shared": true,
"notifications": {
"enabled": false
},
"amountOfCompanies": 500,
"newResults": 25,
"updatedAt": "2024-11-19T12:00:00.000Z",
"createdAt": "2024-10-05T11:30:10.000Z",
"createdBy": "john.smith@example.com"
},
{
"id": 1123581321,
"name": "Static List A",
"type": "STATIC",
"columns": ["description"],
"shared": false,
"notifications": {
"enabled": false
},
"amountOfCompanies": 8,
"newResults": null,
"updatedAt": "2024-11-16T18:15:19.000Z",
"createdAt": "2024-09-25T14:10:00.000Z",
"createdBy": "alex.brown@example.com"
},
{
"id": 9988776655,
"name": "Updated AI Filters",
"type": "SMART",
"columns": [
"description"
],
"shared": false,
"notifications": {
"enabled": false
},
"amountOfCompanies": 120,
"newResults": 10,
"updatedAt": "2024-11-19T07:45:00.000Z",
"createdAt": "2024-10-10T10:20:10.000Z",
"createdBy": "lisa.white@example.com"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 50
}
}
```
# Details
Source: https://docs.bizzy.ai/api-reference/v1/lists/single
GET /v1/lists/{id}
## Request
#### Path
## Response
The following fields can have a set of values:
type can be either `STATIC` or `SMART`
For **smart lists**, it returns a number indicating the count of new results based on the applied filters.
For **static lists**, it is always set to `null`.
Notifications can only be enabled for **static lists** at this time.
```json Response - 200 theme={null}
{
"data": [
{
"id": 1357924680,
"name": "Example List One",
"type": "STATIC",
"columns": [
"activities",
"vatNumber",
"country",
"url",
"socials"
],
"shared": false,
"notifications": {
"enabled": true
},
"amountOfCompanies": 15,
"newResults": null,
"updatedAt": "2024-11-18T10:30:00.000Z",
"createdAt": "2024-10-20T08:45:00.000Z",
"createdBy": "jane.doe@example.com"
}
],
}
```
# Postman collection
Source: https://docs.bizzy.ai/api-reference/v1/postman-collection
[https://drive.google.com/file/d/18yoSdt0n3qq5whueXrJK51pl9syszp5O](https://drive.google.com/file/d/18yoSdt0n3qq5whueXrJK51pl9syszp5O)
# Rate Limiting
Source: https://docs.bizzy.ai/api-reference/v1/rateLimiting
V1 endpoints are limited to 200 requests per minute, counted per API key (the `Authorization` header).
If you exceed this limit, you'll receive a `429 Too Many Requests` response.
# Supported countries
Source: https://docs.bizzy.ai/api-reference/v1/supported-countries
The **V1 API** supports the following country codes: `BE` Belgium, `NL` Netherlands, `FR` France.
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/agents/introduction
With our Agents API, you can fetch the agents configured in your workspace.
This API is uncharged — requests do not consume credits.
## Agent status
Each agent has a derived `status`:
* `DRAFT` — not yet activated
* `ACTIVE` — running
* `PAUSED` — temporarily stopped
* `ARCHIVED` — archived
Only active (non-archived) agents are returned by the
[overview](/api-reference/v2/agents/overview) endpoint.
## Identifiers
Agent IDs (`agentId`) are obfuscated.
## Authorization
The Public API token is team-scoped. Only agents that belong to your team are returned.
# Overview
Source: https://docs.bizzy.ai/api-reference/v2/agents/overview
GET /v2/agents
## Request
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
## Response
The agent type, e.g. `LEAD_GENERATION`.
One of `DRAFT`, `ACTIVE`, `PAUSED` or `ARCHIVED`.
A derived description of the agent.
```json Response - 200 theme={null}
{
"data": [
{
"agentId": "553311",
"name": "Belgian SaaS prospector",
"type": "LEAD_GENERATION",
"status": "ACTIVE",
"summary": "Finds Belgian SaaS companies matching your ICP.",
"avatarUrl": null,
"createdAt": "2026-05-20T08:45:00.000Z",
"updatedAt": "2026-06-18T10:30:00.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 3
}
}
```
# Contact Details
Source: https://docs.bizzy.ai/api-reference/v2/company/contactDetails
GET /v2/companies/{companyId}/contacts/{contactId}
## Request
#### Path
Obfuscated companyId returned by the search endpoint.
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](./contactEnrich) and poll [Enrichment Status](../enrichments/status) for the result.
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`
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`
The contact's email address, or `null` when not available.
Status of the returned email address. One of:
* `VALID`
* `CATCHALL`
* `NOT_FOUND`
* `null` (when the email has not been enriched)
Mobile phone in the following format: `+32 000 00 00 00`
The data provider of the mobile phone number.
* `PROSPEO`
* `CLEON1`
* `FORAGER`
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`
```json Response - 200 theme={null}
{
"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
}
}
}
```
# Bulk Contact Details
Source: https://docs.bizzy.ai/api-reference/v2/company/contactDetailsBulk
POST /v2/companies/contacts/details
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
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](./contactEnrichBulk) and poll [Enrichment Status](../enrichments/status) for each result.
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`
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`
The contact's email address, or `null` when not available.
Status of the returned email address. One of:
* `VALID`
* `CATCHALL`
* `NOT_FOUND`
* `null` (when the email has not been enriched)
Mobile phone in the following format: `+32 000 00 00 00`
The data provider of the mobile phone number.
* `PROSPEO`
* `CLEON1`
* `FORAGER`
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`
```json Response - 200 theme={null}
[
{
"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"
},
]
```
# Enrich Contact
Source: https://docs.bizzy.ai/api-reference/v2/company/contactEnrich
POST /v2/companies/{companyId}/contacts/{contactId}/enrich
Queues an email and/or mobile phone enrichment for a contact. This endpoint always returns immediately with a `PENDING` job — poll [Enrichment Status](../enrichments/status) with the returned `enrichmentId` to get the result.
Enriching costs credits - see the [Credit usage section](../credits)
## Request
#### Path
Obfuscated companyId returned by the search endpoint.
ContactId is the unique identifier of the contact.
#### Body
Enrich the contact with an email address, if available.
Enrich the contact with a mobile phone number, if available.
At least one of `enrichEmail` or `enrichMobilePhone` must be `true`.
## Response
Returns `202 Accepted` with a `Location` header pointing at `/enrichments/{enrichmentId}`.
When the enrichment resolves synchronously (nothing to queue) and a credit is charged, the response includes `X-Bizzy-Credits-Balance` and `X-Bizzy-Credits-Charged` headers — see [Credit usage](../credits).
Obfuscated id used to poll the [Enrichment Status](../enrichments/status) endpoint.
Always `PENDING` on creation.
```json Response - 202 theme={null}
{
"enrichmentId": "8817263",
"status": "PENDING"
}
```
# Bulk Enrich Contacts
Source: https://docs.bizzy.ai/api-reference/v2/company/contactEnrichBulk
POST /v2/companies/contacts/details/enrich
Queues email and/or mobile phone enrichment for many (company, contact) pairs at once. Returns one result per requested pair, in request order — poll each result's `enrichmentId` via [Enrichment Status](../enrichments/status). A bad or unaffordable pair degrades to a per-item `message` instead of failing the whole batch.
Enriching costs credits - see the [Credit usage section](../credits)
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
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.
Enrich contacts with an email address, if available.
Enrich contacts with a mobile phone number, if available.
At least one of `enrichEmail` or `enrichMobilePhone` must be `true`.
## Response
Returns `202 Accepted`. Unlike the single endpoint, no `Location` header is set (there's no single created resource to point at).
When any pair in the batch is charged, the response includes `X-Bizzy-Credits-Balance` and `X-Bizzy-Credits-Charged` headers — the balance reflects the post-charge total, and the charged amount is summed across all charged pairs in the batch. See [Credit usage](../credits).
One entry per requested (company, contact) pair, in request order.
Obfuscated id used to poll the [Enrichment Status](../enrichments/status) endpoint. `null` when `message` is set.
Always `PENDING` on creation, or `null` when `message` is set.
Set when this pair could not be queued (e.g. contact not found), leaving `enrichmentId`/`status` `null`. Other pairs in the batch are unaffected.
```json Response - 202 theme={null}
{
"results": [
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"contactIdentifier": {
"contactId": "1234567890",
"firstName": "John",
"lastName": "Doe"
},
"enrichmentId": "8817263",
"status": "PENDING",
"message": null
},
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"contactIdentifier": {
"contactId": "123",
"firstName": null,
"lastName": ""
},
"enrichmentId": null,
"status": null,
"message": "Contact not found"
}
]
}
```
# Contacts
Source: https://docs.bizzy.ai/api-reference/v2/company/contacts
GET /v2/companies/{companyId}/contacts
## Request
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
You can query on name or jobTitle.
Return only contacts with official roles.
Number of items to return per page. (max 500)
Number of items to skip.
You can chain multiple seniorities.
For example, use `C_LEVEL,NON_MANAGEMENT` to search for both C-Level and
Non-Management roles.
* `C_LEVEL`
* `FOUNDER`
* `OWNER`
* `OFFICIAL_DIRECTOR`
* `PARTNER`
* `VP`
* `DIRECTOR`
* `SENIOR`
* `MANAGER`
* `ENTRY`
* `INTERN`
* `NON_MANAGEMENT`
You can chain multiple departments.
For example, use `SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT` to search for
both Software-engineering and Product-Management departments.
* `C_SUITE`,
* `ENGINEERING_AND_IT`,
* `DESIGN`,
* `EDUCATION`,
* `FINANCE`,
* `HUMAN_RESOURCES`,
* `LEGAL`,
* `MARKETING`,
* `MEDICAL_HEALTH`,
* `OPERATIONS`,
* `CONSULTING`,
* `SALES`,
* `BOARD_OF_DIRECTORS`,
* `RESEARCH_AND_DEVELOPMENT`,
* `AGRICULTURE`,
* `MANUFACTURING`,
* `CONSTRUCTION`,
* `HOSPITALITY`,
* `MEDICAL_AND_HEALTH`,
You can chain multiple official roles.
For example, use `FOUNDER,COOWNER` to search for both Founder and Co-owner
official roles.
* `ACTING_BAILIFF`
* `ADMINISTRATOR`
* `ASSOCIATE`
* `AUDITOR`
* `BOARD_MEMBER`
* `CHAIRMAN`
* `CHAIRMAN_OF_STATUTORY_AUDITORS`
* `CHARTERED_ACCOUNTANT`
* `CURATOR`
* `DEPUTY_MANAGING_DIRECTOR`
* `DEPUTY_PERMANENT_REPRESENTATIVE`
* `EXTERNAL_ACCOUNTANT`
* `FOUNDER`
* `GENERAL_ADMINISTRATOR`
* `GENERAL_AGENT`
* `GOVERNMENT_COMMISSIONER`
* `JUDICIAL_BOARD`
* `JUDICIAL_TRUSTEE`
* `LEGAL_REPRESENTATIVE`
* `MANAGER`
* `MANAGING_DIRECTOR`
* `MAYOR`
* `MEMBER_OF_AREA_ASSOCIATION`
* `PERMANENT_REPRESENTATIVE`
* `AUDITOR_PERMANENT_REPRESENTATIVE`
* `PERSON_IN_CHARGE`
* `PROPERTY_MANAGER`
* `REGISTERED_AUDITOR`
* `REGISTERED_TAX_EXPERT`
* `REPRESENTATIVE`
* `REPRESENTATIVE_NON_ADMIN`
* `SEQUESTER`
* `SUPPLY_SOLICITOR`
* `TREASURER`
* `TRUSTEE`
* `VICE_PRESIDENT`
* `SHAREHOLDER`
* `OTHER`
* `CIC_MANAGER`
* `LLP_MEMBER`
* `MANAGER_OF_AN_EEIG`
* `MEMBER_OF_A_MANAGEMENT_ORGAN`
* `MEMBER_OF_A_SUPERVISORY_ORGAN`
* `MEMBER_OF_AN_ADMINISTRATIVE_ORGAN`
* `NOMINEE_DIRECTOR`
* `NOMINEE_SECRETARY`
* `SECRETARY`
* `DIRECTOR`
* `GENERAL_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `JUDICIAL_FACTOR`
* `LIMITED_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `LLP_DESIGNATED_MEMBER`
* `PERSON_AUTHORISED_TO_ACCEPT`
* `PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT`
* `RECEIVER_AND_MANAGER`
* `ABSOLUTE_PARENT`
* `MEMBER`
* `MANAGEMENT_CONTROLLER`
* `ACCOUNT_CONTROLLER`
* `OTHER_MAJORITY_PARTNER`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_MANAGER_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_MANAGER_PARTNER`
* `LIQUIDATOR`
* `SOLE_PARTNER_ACTIVE_IN_EURL`
* `PRESIDENT_OF_BOARD_OF_DIRECTORS`
* `PRESIDENT_OF_EXECUTIVE_BOARD`
* `GENERAL_DIRECTOR`
* `FOREIGN_ENTITY_FOREIGN_EXECUTIVE`
* `FOREIGN_ENTITY_FRENCH_EXECUTIVE`
* `PRESIDENT_AND_GENERAL_DIRECTOR_OF_BOARD`
* `PRESIDENT_OF_SUPERVISORY_BOARD`
* `EXECUTIVE_BOARD_MEMBER`
* `SUPERVISORY_BOARD_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_COMPANY`
* `PERSON_AUTHORIZED_TO_REPRESENT_ESTABLISHMENT`
* `CHIEF_EXECUTIVE_OFFICER`
* `DEPUTY_GENERAL_DIRECTOR`
* `STATUTORY_AUDITOR`
* `ALTERNATE_AUDITOR`
* `PRESIDENT_OF_SAS`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_PARTNER`
* `FOREIGN_COMPANY_FRENCH_SOCIAL_REPRESENTATIVE`
* `FOREIGN_COMPANY_FRENCH_FISCAL_REPRESENTATIVE`
* `COOWNER`
* `OPERATOR_FOR_COOWNERSHIP`
* `PHYSICAL_PERSON_OPERATING_TOGETHER`
* `SPECIAL_AGENT`
* `TEMPORARY_ADMINISTRATOR`
* `UNSALARIED_MEMBER_PARTICIPATING_IN_WORK`
* `PARTNER_INVOLVED_IN_MANAGEMENT`
* `UNSALARIED_PARTNER`
* `ACQUIRER`
* `ENTREPRENEUR`
* `DEPUTY`
* `DESIGNATED_DECISION_MAKER`
* `ACCOUNTANT`
* `COOWNER_HEIR`
* `LESSOR`
* `BENIFICIAL_OWNER`
* `TAX_AGENT`
* `VICE_PRESIDENT_MANAGEMENT`
* `VICE_PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `MEMBER_ORIENTATION_AND_SURVEILLANCE`
* `SOLE_PARTNER_ASSET_RECOVERY`
* `GENERAL_PARTNER`
* `PRESIDENT_OF_EPIC`
* `LAWYER`
* `TAX_REPRESENTATIVE`
* `BENFICIAL_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_ENTITY`
* `PRESIDENT`
* `GENERAL_SECRETARY`
* `UNION_BOARD_MEMBER`
* `UNION_BOARD_PRESIDENT`
* `PERSON_DESIGNATED_BY_BYLAWS`
## 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.
The contact's job title, or `null` when not available.
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy ",
},
"data": [
{
"contactIdentifier": {
"contactId": "1740201639",
"firstName": "Steve",
"lastName": "Declercq"
},
"jobTitle": "Chief Executive Officer"
},
{
"contactIdentifier": {
"contactId": "1280731968",
"firstName": "Hendrik",
"lastName": "Keeris"
},
"jobTitle": "Chief Technology Officer"
},
{
"contactIdentifier": {
"contactId": "1858956880",
"firstName": "David",
"lastName": "Du Pré"
},
"jobTitle": "Sales Manager"
},
{
"contactIdentifier": {
"contactId": "1122224600",
"firstName": "Piet",
"lastName": "Casneuf"
},
"jobTitle": null
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 39
}
}
```
# Bulk Contacts
Source: https://docs.bizzy.ai/api-reference/v2/company/contactsBulk
POST /v2/companies/contacts
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
You can query on name or jobTitle.
Return only contacts with official roles.
You can chain multiple seniorities.
For example, use `C_LEVEL,NON_MANAGEMENT` to search for both C-Level and
Non-Management roles.
* `C_LEVEL`
* `FOUNDER`
* `OWNER`
* `OFFICIAL_DIRECTOR`
* `PARTNER`
* `VP`
* `DIRECTOR`
* `SENIOR`
* `MANAGER`
* `ENTRY`
* `INTERN`
* `NON_MANAGEMENT`
You can chain multiple departments.
For example, use `SOFTWARE_ENGINEERING,PRODUCT_MANAGEMENT` to search for
both Software-engineering and Product-Management departments.
* `C_SUITE`,
* `ENGINEERING_AND_IT`,
* `DESIGN`,
* `EDUCATION`,
* `FINANCE`,
* `HUMAN_RESOURCES`,
* `LEGAL`,
* `MARKETING`,
* `MEDICAL_HEALTH`,
* `OPERATIONS`,
* `CONSULTING`,
* `SALES`,
* `BOARD_OF_DIRECTORS`,
* `RESEARCH_AND_DEVELOPMENT`,
* `AGRICULTURE`,
* `MANUFACTURING`,
* `CONSTRUCTION`,
* `HOSPITALITY`,
* `MEDICAL_AND_HEALTH`,
You can chain multiple official roles.
For example, use `FOUNDER,COOWNER` to search for both Founder and Co-owner
official roles.
* `ACTING_BAILIFF`
* `ADMINISTRATOR`
* `ASSOCIATE`
* `AUDITOR`
* `BOARD_MEMBER`
* `CHAIRMAN`
* `CHAIRMAN_OF_STATUTORY_AUDITORS`
* `CHARTERED_ACCOUNTANT`
* `CURATOR`
* `DEPUTY_MANAGING_DIRECTOR`
* `DEPUTY_PERMANENT_REPRESENTATIVE`
* `EXTERNAL_ACCOUNTANT`
* `FOUNDER`
* `GENERAL_ADMINISTRATOR`
* `GENERAL_AGENT`
* `GOVERNMENT_COMMISSIONER`
* `JUDICIAL_BOARD`
* `JUDICIAL_TRUSTEE`
* `LEGAL_REPRESENTATIVE`
* `MANAGER`
* `MANAGING_DIRECTOR`
* `MAYOR`
* `MEMBER_OF_AREA_ASSOCIATION`
* `PERMANENT_REPRESENTATIVE`
* `AUDITOR_PERMANENT_REPRESENTATIVE`
* `PERSON_IN_CHARGE`
* `PROPERTY_MANAGER`
* `REGISTERED_AUDITOR`
* `REGISTERED_TAX_EXPERT`
* `REPRESENTATIVE`
* `REPRESENTATIVE_NON_ADMIN`
* `SEQUESTER`
* `SUPPLY_SOLICITOR`
* `TREASURER`
* `TRUSTEE`
* `VICE_PRESIDENT`
* `SHAREHOLDER`
* `OTHER`
* `CIC_MANAGER`
* `LLP_MEMBER`
* `MANAGER_OF_AN_EEIG`
* `MEMBER_OF_A_MANAGEMENT_ORGAN`
* `MEMBER_OF_A_SUPERVISORY_ORGAN`
* `MEMBER_OF_AN_ADMINISTRATIVE_ORGAN`
* `NOMINEE_DIRECTOR`
* `NOMINEE_SECRETARY`
* `SECRETARY`
* `DIRECTOR`
* `GENERAL_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `JUDICIAL_FACTOR`
* `LIMITED_PARTNER_IN_A_LIMITED_PARTNERSHIP`
* `LLP_DESIGNATED_MEMBER`
* `PERSON_AUTHORISED_TO_ACCEPT`
* `PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT`
* `RECEIVER_AND_MANAGER`
* `ABSOLUTE_PARENT`
* `MEMBER`
* `MANAGEMENT_CONTROLLER`
* `ACCOUNT_CONTROLLER`
* `OTHER_MAJORITY_PARTNER`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_MANAGER_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_MANAGER_PARTNER`
* `LIQUIDATOR`
* `SOLE_PARTNER_ACTIVE_IN_EURL`
* `PRESIDENT_OF_BOARD_OF_DIRECTORS`
* `PRESIDENT_OF_EXECUTIVE_BOARD`
* `GENERAL_DIRECTOR`
* `FOREIGN_ENTITY_FOREIGN_EXECUTIVE`
* `FOREIGN_ENTITY_FRENCH_EXECUTIVE`
* `PRESIDENT_AND_GENERAL_DIRECTOR_OF_BOARD`
* `PRESIDENT_OF_SUPERVISORY_BOARD`
* `EXECUTIVE_BOARD_MEMBER`
* `SUPERVISORY_BOARD_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_COMPANY`
* `PERSON_AUTHORIZED_TO_REPRESENT_ESTABLISHMENT`
* `CHIEF_EXECUTIVE_OFFICER`
* `DEPUTY_GENERAL_DIRECTOR`
* `STATUTORY_AUDITOR`
* `ALTERNATE_AUDITOR`
* `PRESIDENT_OF_SAS`
* `JOINT_INDEFINITELY_AND_SEVERALLY_LIABLE_PARTNER`
* `JOINT_INDEFINITELY_LIABLE_PARTNER`
* `FOREIGN_COMPANY_FRENCH_SOCIAL_REPRESENTATIVE`
* `FOREIGN_COMPANY_FRENCH_FISCAL_REPRESENTATIVE`
* `COOWNER`
* `OPERATOR_FOR_COOWNERSHIP`
* `PHYSICAL_PERSON_OPERATING_TOGETHER`
* `SPECIAL_AGENT`
* `TEMPORARY_ADMINISTRATOR`
* `UNSALARIED_MEMBER_PARTICIPATING_IN_WORK`
* `PARTNER_INVOLVED_IN_MANAGEMENT`
* `UNSALARIED_PARTNER`
* `ACQUIRER`
* `ENTREPRENEUR`
* `DEPUTY`
* `DESIGNATED_DECISION_MAKER`
* `ACCOUNTANT`
* `COOWNER_HEIR`
* `LESSOR`
* `BENIFICIAL_OWNER`
* `TAX_AGENT`
* `VICE_PRESIDENT_MANAGEMENT`
* `VICE_PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `PRESIDENT_ORIENTATION_AND_SURVEILLANCE`
* `MEMBER_ORIENTATION_AND_SURVEILLANCE`
* `SOLE_PARTNER_ASSET_RECOVERY`
* `GENERAL_PARTNER`
* `PRESIDENT_OF_EPIC`
* `LAWYER`
* `TAX_REPRESENTATIVE`
* `BENFICIAL_MEMBER`
* `PERSON_AUTHORIZED_TO_REPRESENT_ENTITY`
* `PRESIDENT`
* `GENERAL_SECRETARY`
* `UNION_BOARD_MEMBER`
* `UNION_BOARD_PRESIDENT`
* `PERSON_DESIGNATED_BY_BYLAWS`
Number of items to return per page. (max 500)
Number of items to skip. `companies.length x limit` may not exceed 500.
## Response
The same limit and offset are shared over all companies.
The contact's job title, or `null` when not available.
**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.
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy ",
},
"data": [
{
"contactIdentifier": {
"contactId": "1740201639",
"firstName": "Steve",
"lastName": "Declercq"
},
"jobTitle": "Chief Executive Officer"
},
{
"contactIdentifier": {
"contactId": "1280731968",
"firstName": "Hendrik",
"lastName": "Keeris"
},
"jobTitle": "Chief Technology Officer"
},
{
"contactIdentifier": {
"contactId": "1858956880",
"firstName": "David",
"lastName": "Du Pré"
},
"jobTitle": "Sales Manager"
},
{
"contactIdentifier": {
"contactId": "1122224600",
"firstName": "Piet",
"lastName": "Casneuf"
},
"jobTitle": null
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 39
},
"message": null
},
{ // Example error
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Details
Source: https://docs.bizzy.ai/api-reference/v2/company/details
GET /v2/companies/{companyId}
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
## Response
The following fields can have a set of values:
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"status": "ACTIVE",
"description": "Bizzy is a B2B intelligence platform that leverages AI to help users discover, qualify, and engage with companies efficiently, providing real-time insights and data integration.",
"logo": "https://storage.googleapis.com/bizzy-company-logos/d079b341-9f0a-4651-ae12-3c083fe86244/7c878f57-b905-4a5f-bf73-3b76724edc95.png",
"establishedSince": "1985-05-24T00:00:00.000Z",
"name": "Bizzy",
"address": {
"country": "BE",
"street": "Dok-Noord",
"number": "5A",
"box": null,
"postalCode": "9000",
"place": "Ghent"
},
"website": [
"https://bizzy.ai"
],
"socials": {
"x": null,
"facebook": null,
"youtube": null,
"instagram": null,
"linkedin": "https://www.linkedin.com/company/71230820/"
},
"contact": {
"email": null,
"phone": null
},
"activities": [
{
"activity": "SOFTWARE_DEVELOPMENT"
},
{
"activity": "DATA_ANALYTICS"
}
],
"revenueEstimations": "Bucket0_1M",
"employeeEstimations": "Bucket20_49"
}
}
```
status can be either `ACTIVE` or `INACTIVE`
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
The email address of the company
The international phone number of the company
'Do Not Call Me' flag
# Bulk Details
Source: https://docs.bizzy.ai/api-reference/v2/company/detailsBulk
POST /v2/companies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
## Response
The following data fields can have a set of values:
status can be either `ACTIVE` or `INACTIVE`
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
The email address of the company
The international phone number of the company
'Do Not Call Me' flag
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"status": "ACTIVE",
"description": "Bizzy is a B2B intelligence platform that leverages AI to help users discover, qualify, and engage with companies efficiently, providing real-time insights and data integration.",
"logo": "https://storage.googleapis.com/bizzy-company-logos/d079b341-9f0a-4651-ae12-3c083fe86244/7c878f57-b905-4a5f-bf73-3b76724edc95.png",
"establishedSince": "1985-05-24T00:00:00.000Z",
"name": "Bizzy",
"address": {
"country": "BE",
"street": "Dok-Noord",
"number": "5A",
"box": null,
"postalCode": "9000",
"place": "Ghent"
},
"website": [
"https://bizzy.ai"
],
"socials": {
"x": null,
"facebook": null,
"youtube": null,
"instagram": null,
"linkedin": "https://www.linkedin.com/company/71230820/"
},
"contact": {
"email": null,
"phone": null
},
"activities": [
{
"activity": "SOFTWARE_DEVELOPMENT"
},
{
"activity": "DATA_ANALYTICS"
}
],
"revenueEstimations": "Bucket0_1M",
"employeeEstimations": "Bucket20_49"
},
"message": null
},
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"message": "Company not found"
}
]
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/company/introduction
With our Companies API, you can fetch details of all companies in our database.
Depending on the used endpoint, we'll return a specific payload.
The basic endpoint is the *'details'*, while all others can be seen as extensions.
## Company identifiers
All company endpoint URLs must contain the country and unique identifier of the required company *(../BE/0770493071/...)*.
By default, this identifier is obfuscated.
This identifier is depending on the official registration country of the company.
The identifiers for the supported countries are the following:
* **Belgium**: Enterprise (KBO) number. This is equal to the VAT without 'BE'.
* **The Netherlands**: KVK number
* **France**: SIREN number
# Legal Entities
Source: https://docs.bizzy.ai/api-reference/v2/company/legalEntities
GET /v2/companies/{companyId}/legal-entities
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
## Response
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": [
{
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
}
]
}
```
# Lookalikes
Source: https://docs.bizzy.ai/api-reference/v2/company/lookalikes
GET /v2/companies/{companyId}/lookalikes
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
## Response
Offset is displayed in pagination response, but defaults to 0 due to dynamic scoring.
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"lookalikes": [
{
"companyIdentifier": {
"countryCode": "IT",
"companyId": "49748317533",
"name": "Bizzynow"
}
},
{
"companyIdentifier": {
"countryCode": "GB",
"companyId": "50332067174",
"name": "Bizko Inc"
}
},
{
"companyIdentifier": {
"countryCode": "GB",
"companyId": "50974991575",
"name": "E-horizon Systems"
}
},
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "51222683020",
"name": "F.t.c."
}
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 10000
}
}
```
# Bulk Lookalikes
Source: https://docs.bizzy.ai/api-reference/v2/company/lookalikesBulk
POST /v2/companies/lookalikes
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
Number of items to return per page. (max 500)
Number of items to skip. `companies.length x limit` may not exceed 500.
## Response
Offset is displayed in pagination response, but defaults to 0 due to dynamic
scoring.
The same limit and offset are shared over all companies.
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"lookalikes": [
{
"companyIdentifier": {
"countryCode": "GB",
"companyId": "50974991575",
"name": "E-horizon Systems"
}
},
{
"companyIdentifier": {
"countryCode": "GB",
"companyId": "50332067174",
"name": "Bizko Inc"
}
},
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "51222683020",
"name": "F.t.c."
}
},
{
"companyIdentifier": {
"countryCode": "CH",
"companyId": "49427557067",
"name": "Salesport"
}
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 10000
},
"message": null
},
{ // Example error
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Search
Source: https://docs.bizzy.ai/api-reference/v2/company/search
GET /v2/companies
**Deprecated.** Use [`GET /v2/search/companies`](/api-reference/v2/search/companies) instead, which supports VAT-number search and pagination and returns a `{ data, pagination }` envelope.
This endpoint is kept for backwards compatibility: it searches by name only, returns a bare array with a fixed page size of 10, and cannot be paginated. Responses include a `Deprecation: true` header and a `Link: ; rel="successor-version"` header.
## Request
#### Query
The name of the company you want to query, up to 20 characters.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries). If omitted, the search runs across all supported countries.
```json Response - 200 theme={null}
[
{
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy AI"
}
]
```
# Technologies
Source: https://docs.bizzy.ai/api-reference/v2/company/technologies
GET /v2/companies/{companyId}/technologies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"technologies": [
{
"name": "Google Tag Manager",
"website": "https://www.google.com/tagmanager",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Tag%20Manager.svg",
"groups": [
"Analytics"
]
},
{
"name": "Google Analytics",
"website": "https://google.com/analytics",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Analytics.svg",
"groups": [
"Analytics"
]
},
{
"name": "Google Font API",
"website": "https://google.com/fonts",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Font%20API.svg",
"groups": [
"Web development"
]
},
{
"name": "Open Graph",
"website": "https://ogp.me",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Open%20Graph.png",
"groups": [
"Other"
]
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 23
}
}
```
# Bulk Technologies
Source: https://docs.bizzy.ai/api-reference/v2/company/technologiesBulk
POST /v2/companies/technologies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
Number of items to return per page. (max 500)
Number of items to skip. `companies.length x limit` may not exceed 500.
## Response
The same limit and offset are shared over all companies.
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"technologies": [
{
"name": "Google Tag Manager",
"website": "https://www.google.com/tagmanager",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Tag%20Manager.svg",
"groups": [
"Analytics"
]
},
{
"name": "Google Analytics",
"website": "https://google.com/analytics",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Analytics.svg",
"groups": [
"Analytics"
]
},
{
"name": "Google Font API",
"website": "https://google.com/fonts",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Google%20Font%20API.svg",
"groups": [
"Web development"
]
},
{
"name": "Open Graph",
"website": "https://ogp.me",
"logoUrl": "https://bizzy.ams3.digitaloceanspaces.com/prod/techstack/icons/Open%20Graph.png",
"groups": [
"Other"
]
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 23
},
"message": null
},
{ // Example error
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Updates
Source: https://docs.bizzy.ai/api-reference/v2/company/updates
GET /v2/companies/{companyId}/updates
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"updates": [
{
"id": "2127510865",
"type": "EXPANSION",
"title": "Platform voor bedrijfsinformatie Bizzy plant eerste buitenlandse stappen"
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Bulk Updates
Source: https://docs.bizzy.ai/api-reference/v2/company/updatesBulk
POST /v2/companies/updates
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
Number of items to return per page. (max 500)
Number of items to skip. `companies.length x limit` may not exceed 500.
## Response
The same limit and offset are shared over all companies.
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"updates": [
{
"id": "2127510865",
"type": "EXPANSION",
"title": "Business intelligence platform Bizzy plans first steps abroad"
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
},
"message": null
},
{ // Example error
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"pagination": null,
"message": "Company not found"
},
]
```
# Vacancies
Source: https://docs.bizzy.ai/api-reference/v2/company/vacancies
GET /v2/companies/{companyId}/vacancies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated companyId returned by the search endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
## Response
The following fields can have a set of values:
The available departments of the contact.
`department` is an array of the following values:
* `C_SUITE`,
* `ENGINEERING_AND_IT`,
* `DESIGN`,
* `EDUCATION`,
* `FINANCE`,
* `HUMAN_RESOURCES`,
* `LEGAL`,
* `MARKETING`,
* `MEDICAL_HEALTH`,
* `OPERATIONS`,
* `CONSULTING`,
* `SALES`,
* `BOARD_OF_DIRECTORS`,
* `RESEARCH_AND_DEVELOPMENT`,
* `AGRICULTURE`,
* `MANUFACTURING`,
* `CONSTRUCTION`,
* `HOSPITALITY`,
* `MEDICAL_AND_HEALTH`,
The available sub-departments of the contact.
`subDepartments` 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`
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`
```json Response - 200 theme={null}
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"vacancies": [
{
"title": "Senior Data Engineer",
"description": null,
"url": "https://bizzy.recruitee.com/o/senior-data-engineer-4",
"location": "Belgium",
"publicationDate": "2026-03-29T04:16:49.000Z",
"department": [],
"subDepartments": [],
"seniority": []
},
{
"title": "Business Development Representative",
"description": "# Business Development Representative\n\n* Hybride\n* + Gent, Vlaams Gewest, België\n* Sales\n\n#### Kickstart your sales career with us! 🚀\n\n**you**!\n\n#### 🔥 What you’ll be doing\n\n* **Build a killer lead pipeline** – Use Bizzy to scout potential leads and make the first move via cold calling.\n* **Create connections** – Find key decision-makers, reach out via calls, emails, social media, and networking events, and craft personalized messages that grab attention.\n* **Qualify like a pro** – Understand prospects’ needs, pain points, and budgets to determine if they’re the right fit.\n* **Set the stage for success** – Book meetings or demos for qualified leads with the sales team and ensure a seamless handover.\n* **Keep it organized** – Maintain accurate records of interactions and key insights in **HubSpot**.\n\nWe’re on the hunt for a **Business Development Representative (BDR)** to join Bizzy and introduce our **B2B Intelligence Platform** to customers. You’ll be the first touchpoint in our sales process, identifying and creating new business opportunities. If you’re ambitious, eager to learn, and ready to grow into an **Account Executive role**, this is your chance to make an impact!\n\n📍 **Location:** Ghent, with flexibility to work from home **2 days per week**.\n\n#### 💡 What makes you a perfect match\n\n#### 🎯 Bonus points if you...\n\n\n\n#### ✨ Why you'll love working with us\n\nAt Bizzy, we grow together, by learning fast, sharing openly, and challenging each other with *Candid Candor*. We believe in honest conversations that move us forward, not in circles.\n\nWe take initiative, act boldly, and *Lead the Way,* not by talking about it, but by doing it. We back each other up, celebrate wins together, and stay *United by Growth*, every step of the way.\n\nYes, we hustle. But we also know when to pause, recharge, and *Unwind,* because sustainable pace beats constant rush.\n\nJoining Bizzy means joining a team that’s shaping the future of sales tech across Europe. If you’re ready to *make your mark and grow fast*, we’d love to meet you.\n\nOn top of a competitive salary, we offer the following benefits:\n\n* 🛠 The right tools to do your job without headaches and drama;\n\n + 💻 Macbook Air\n + 📱iPhone 16 (with subscription)\n* 🏥 Healthcare benefits plan (incl Alan daily care)\n* 🥪 Meal vouchers\n* ⚖ A Flex Income Plan through Payflip\n* 🕛 Flexible working hours and locations, although we love to connect in person at least three days a week.\n* 🧑🎓 Dedicated budget to support your growth and development\n* 🎁 Awesome Bizzy merchandise\n* 🍺 🎉 🏂 Team drinks and events\n\n***🌈 Diverse teams build better products. That starts with you.***\n\n* **Positive & Enthusiastic** – Your energy is contagious and makes a difference.\n* **Team Player** – You thrive in a collaborative environment and share insights to help the team win.\n* **Driven & Self-Motivated** – You don’t wait for opportunities, you create them.\n* **Organized & Efficient** – You juggle multiple leads and prioritize like a pro.\n* **Curious & Eager to Learn** – You ask the right questions, love learning, and always seek improvement.\n* **Resilient & Persistent**\n* **Fluent in Dutch & English** – You’re a native Dutch speaker and communicate fluently in English. French is a strong plus!\n\n- Have experience working in **Hubspot**",
"url": "https://bizzy.recruitee.com/o/business-development-representative",
"location": "Ghent",
"publicationDate": "2026-02-07T11:03:40.000Z",
"department": [],
"subDepartments": [],
"seniority": []
}
],
"totalVacancies": 2,
"numberOfNewVacancies": 1
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
}
}
```
# Bulk Vacancies
Source: https://docs.bizzy.ai/api-reference/v2/company/vacanciesBulk
POST /v2/companies/vacancies
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated companyId returned by the search endpoint.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
You can request up to 100 companies at once.
Number of items to return per page. (max 500)
Number of items to skip. `companies.length x limit` may not exceed 500.
## Response
The same limit and offset are shared over all companies.
The following fields can have a set of values:
The available departments of the contact.
`department` is an array of the following values:
* `C_SUITE`,
* `ENGINEERING_AND_IT`,
* `DESIGN`,
* `EDUCATION`,
* `FINANCE`,
* `HUMAN_RESOURCES`,
* `LEGAL`,
* `MARKETING`,
* `MEDICAL_HEALTH`,
* `OPERATIONS`,
* `CONSULTING`,
* `SALES`,
* `BOARD_OF_DIRECTORS`,
* `RESEARCH_AND_DEVELOPMENT`,
* `AGRICULTURE`,
* `MANUFACTURING`,
* `CONSTRUCTION`,
* `HOSPITALITY`,
* `MEDICAL_AND_HEALTH`,
The available sub-departments of the contact.
`subDepartments` 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`
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`
```json Response - 200 theme={null}
[
{
"companyIdentifier": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
},
"data": {
"vacancies": [
{
"title": "Senior Data Engineer",
"description": null,
"url": "https://bizzy.recruitee.com/o/senior-data-engineer-4",
"location": "Belgium",
"publicationDate": "2026-03-29T04:16:49.000Z",
"department": [],
"subDepartments": [],
"seniority": []
},
{
"title": "Business Development Representative",
"description": "# Business Development Representative\n\n* Hybride\n* + Gent, Vlaams Gewest, België\n* Sales\n\n#### Kickstart your sales career with us! 🚀\n\n**you**!\n\n#### 🔥 What you’ll be doing\n\n* **Build a killer lead pipeline** – Use Bizzy to scout potential leads and make the first move via cold calling.\n* **Create connections** – Find key decision-makers, reach out via calls, emails, social media, and networking events, and craft personalized messages that grab attention.\n* **Qualify like a pro** – Understand prospects’ needs, pain points, and budgets to determine if they’re the right fit.\n* **Set the stage for success** – Book meetings or demos for qualified leads with the sales team and ensure a seamless handover.\n* **Keep it organized** – Maintain accurate records of interactions and key insights in **HubSpot**.\n\nWe’re on the hunt for a **Business Development Representative (BDR)** to join Bizzy and introduce our **B2B Intelligence Platform** to customers. You’ll be the first touchpoint in our sales process, identifying and creating new business opportunities. If you’re ambitious, eager to learn, and ready to grow into an **Account Executive role**, this is your chance to make an impact!\n\n📍 **Location:** Ghent, with flexibility to work from home **2 days per week**.\n\n#### 💡 What makes you a perfect match\n\n#### 🎯 Bonus points if you...\n\n\n\n#### ✨ Why you'll love working with us\n\nAt Bizzy, we grow together, by learning fast, sharing openly, and challenging each other with *Candid Candor*. We believe in honest conversations that move us forward, not in circles.\n\nWe take initiative, act boldly, and *Lead the Way,* not by talking about it, but by doing it. We back each other up, celebrate wins together, and stay *United by Growth*, every step of the way.\n\nYes, we hustle. But we also know when to pause, recharge, and *Unwind,* because sustainable pace beats constant rush.\n\nJoining Bizzy means joining a team that’s shaping the future of sales tech across Europe. If you’re ready to *make your mark and grow fast*, we’d love to meet you.\n\nOn top of a competitive salary, we offer the following benefits:\n\n* 🛠 The right tools to do your job without headaches and drama;\n\n + 💻 Macbook Air\n + 📱iPhone 16 (with subscription)\n* 🏥 Healthcare benefits plan (incl Alan daily care)\n* 🥪 Meal vouchers\n* ⚖ A Flex Income Plan through Payflip\n* 🕛 Flexible working hours and locations, although we love to connect in person at least three days a week.\n* 🧑🎓 Dedicated budget to support your growth and development\n* 🎁 Awesome Bizzy merchandise\n* 🍺 🎉 🏂 Team drinks and events\n\n***🌈 Diverse teams build better products. That starts with you.***\n\n* **Positive & Enthusiastic** – Your energy is contagious and makes a difference.\n* **Team Player** – You thrive in a collaborative environment and share insights to help the team win.\n* **Driven & Self-Motivated** – You don’t wait for opportunities, you create them.\n* **Organized & Efficient** – You juggle multiple leads and prioritize like a pro.\n* **Curious & Eager to Learn** – You ask the right questions, love learning, and always seek improvement.\n* **Resilient & Persistent**\n* **Fluent in Dutch & English** – You’re a native Dutch speaker and communicate fluently in English. French is a strong plus!\n\n- Have experience working in **Hubspot**",
"url": "https://bizzy.recruitee.com/o/business-development-representative",
"location": "Ghent",
"publicationDate": "2026-02-07T11:03:40.000Z",
"department": [],
"subDepartments": [],
"seniority": []
}
],
"totalVacancies": 2,
"numberOfNewVacancies": 1
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 2
},
"message": null
},
{ // Example error
"companyIdentifier": {
"countryCode": "BE",
"companyId": "123",
"name": ""
},
"data": null,
"pagination": null,
"message": "Company not found"
}
]
```
# Credit usage
Source: https://docs.bizzy.ai/api-reference/v2/credits
# Introduction
A credit will be charged when fetching a company or legal entity for the first time. You'll then be able to get all details for free in the next 30 days.
The endpoints for which a credit will be charged the first time you access the company or legal entity are `Company Details`, `Legal Entity Details`, `Legal Entity Financials`, `Lookalikes`, `Contacts`. All other endpoints are free of use, like `Search` and list endpoints.
## Enriching contacts
Contact enrichment is asynchronous: queue it via [Enrich Contact](./company/contactEnrich) or [Bulk Enrich Contacts](./company/contactEnrichBulk), then poll [Enrichment Status](./enrichments/status) for the result. The `Contact Details` endpoints no longer enrich inline.
You will only be charged for enrichments when data is **available**.
If no data is available, no credits will be charged.
### Emails
A credit will be charged when enriching a contact with an email address.
### Mobile phone numbers
* **2 credits** will be charged when enriching a contact with a mobile phone number, **if the API user does not have a connected Prospeo account**.
* **1 credit** will be charged if the **API user has a connected Prospeo account**.
## Response header
The response header will contain the following fields:
* `X-Bizzy-Credits-Balance`: Your remaining credit balance
* `X-Bizzy-Credits-Charged`: The number of credits charged for this request
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/enrichments/introduction
With our Enrichments API, you can enrich a contact's email address and/or mobile phone number asynchronously and track the result.
## Lifecycle
Enrichments are queued from [Enrich Contact](/api-reference/v2/company/contactEnrich) or
[Bulk Enrich Contacts](/api-reference/v2/company/contactEnrichBulk), which return one or more
`enrichmentId` values. Use the [status](/api-reference/v2/enrichments/status) endpoint to poll
each enrichment until it completes.
## Status values
| Status | Description |
| ------------ | ------------------------------------------------------------------------------------------------------------------------- |
| `PENDING` | The enrichment is queued and waiting to start. |
| `PROCESSING` | The enrichment is actively being worked on. |
| `COMPLETED` | The enrichment finished; `data` contains the result. |
| `FAILED` | The enrichment job failed. |
| `TIMED_OUT` | The enrichment got stuck processing; submit a new enrichment. |
| `EXPIRED` | The enrichment previously completed, but its charge-dedup window has since lapsed; submit a new enrichment to refresh it. |
## Authorization
The Public API token is team-scoped. You can only track enrichments that belong to your team;
requesting one from another team returns `404`.
# Status
Source: https://docs.bizzy.ai/api-reference/v2/enrichments/status
GET /v2/enrichments/{enrichmentId}
Poll this endpoint with the `enrichmentId` returned by [Enrich Contact](../company/contactEnrich) or [Bulk Enrich Contacts](../company/contactEnrichBulk).
## Request
#### Path
Obfuscated id returned when creating an enrichment.
## Response
While `status` is `PENDING` or `PROCESSING`, the response includes a `Retry-After` header (in seconds) suggesting when to poll again.
Same value as the `enrichmentId` path parameter.
One of:
* `PENDING` — queued, not yet picked up.
* `PROCESSING` — actively being worked on.
* `COMPLETED` — finished; `data` contains the result.
* `FAILED` — the enrichment job failed.
* `TIMED_OUT` — stuck processing past the expected time; submit a new enrichment.
* `EXPIRED` — previously completed, but the underlying charge-dedup window has since lapsed; submit a new enrichment to refresh it.
Present (non-null) only when `status` is `COMPLETED`.
The contact's enriched email address, or `null` when not found or not requested.
The contact's enriched mobile phone number, or `null` when not found or not requested.
```json Response - 200 (COMPLETED) theme={null}
{
"enrichmentId": "8817263",
"status": "COMPLETED",
"data": {
"email": "info@bizzy.ai",
"mobileNumber": "+32 000 00 00 00"
}
}
```
```json Response - 200 (PROCESSING) theme={null}
{
"enrichmentId": "8817263",
"status": "PROCESSING",
"data": null
}
```
# Error handling
Source: https://docs.bizzy.ai/api-reference/v2/errors
## Available error codes
| Status | Description |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400 | Bad request. The request or the request body is invalid. Examples: missing required fields, invalid field format. |
| 401 | Unauthorized. The request requires authentication. This usually means the API key is missing or invalid. |
| 402 | Insufficient credits. You do not have enough credits to perform this request. See [Credit usage](/api-reference/v2/credits) for more information. |
| 403 | Forbidden. The request is not allowed. This may be due to insufficient privileges or attempting to access resources belonging to another user. |
| 404 | Not found. The requested resource does not exist. This could be due to an incorrect ID or an invalid endpoint. |
| 429 | Too many requests. You have exceeded the rate limit. See [Rate limiting](/api-reference/v2/rateLimiting) for more information. |
| 500 | Internal server error. Something went wrong on our side. If this persists, please contact support with the request details so we can investigate. |
## Error format
v2 errors always include a `message` field, but the response envelope otherwise mirrors the shape of a successful response for that endpoint — fields such as the entity identifier (e.g. `companyIdentifier`, `legalEntityIdentifier`) and `data` (and, where applicable, endpoint-specific fields like `pagination` or `range`) are present but set to `null`.
```json Companies theme={null}
{
"companyIdentifier": null,
"data": null,
"message": "Company not found"
}
```
```json Legal Entities theme={null}
{
"legalEntityIdentifier": null,
"data": null,
"message": "Legal entity not found"
}
```
```json Lists / Saved Searches / Exports / Agents theme={null}
{
"data": null,
"message": "List not found"
}
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/exports/introduction
With our Exports API, you can track the status of an export and retrieve its download URL.
## Lifecycle
Exports are queued from the [Lists API](/api-reference/v2/lists/export), which returns an
`exportId`. Use that id with the [status](/api-reference/v2/exports/status) endpoint to poll
the export until it is ready, then download it from the returned `url`.
## Status values
| Status | Description |
| ---------------------- | ---------------------------------------------------------- |
| `PENDING` | The export is queued and waiting to start. |
| `IN_PROGRESS` | The export is being generated. |
| `AVAILABLE` | The export is ready; `url` contains a download link. |
| `EXPIRED` | The export is no longer available for download. |
| `FAILED` | The export failed to generate. |
| `INSUFFICIENT_CREDITS` | The export could not complete due to insufficient credits. |
| `NO_RESULTS` | The list produced no exportable results. |
## Authorization
The Public API token is team-scoped. You can only track exports that belong to your team;
requesting one from another team returns `404`.
# Status
Source: https://docs.bizzy.ai/api-reference/v2/exports/status
GET /v2/exports/{exportId}
## Request
#### Path
Obfuscated exportId returned when queuing an export.
## Response
Obfuscated exportId, same value as the `exportId` path parameter.
Name of the export.
One of `PENDING`, `IN_PROGRESS`, `AVAILABLE`, `EXPIRED`, `FAILED`,
`INSUFFICIENT_CREDITS` or `NO_RESULTS`.
Completion ratio between `0` and `1`, rounded to two decimals.
Presigned download URL. Only present (non-null) when `status` is `AVAILABLE`.
```json Response - 200 theme={null}
{
"id": "8817263",
"name": "Example List export",
"status": "AVAILABLE",
"progress": 1,
"url": "https://storage.googleapis.com/bizzy-exports/..."
}
```
# Details
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/details
GET /v2/legal-entities/{legalEntityId}
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
## Response
The following fields can have a set of values:
legalStatus can be one of the following:
* `NORMAL_SITUATION`
* `LEGAL_CREATION`
* `EX_OFFICIO_LIQUIDATION_AFTER_TERM_EXPIRATION`
* `CESSATION_OF_ACTIVITIES_IN_COUNTRY`
* `VOLUNTARY_DISSOLUTIONVOLUNTARY_LIQUIDATION`
* `COMPULSORY_DISSOLUTION`
* `END_OF_DISSOLUTION`
* `START_OF_DISSOLUTION`
* `CESSATION_OF_ENTITY_WITHOUT_LEGAL_PERSONALITY`
* `CESSATIONTRANSFER_OF_REGISTERED_ENTITY_NATURAL_PERSON`
* `CESSATION_DURING_IDENTIFICATION`
* `CESSATION_OF_EDRL_OR_NON_EU_ENTITY`
* `SHARES_HELD_BY_SINGLE_SHAREHOLDER`
* `MERGER_BY_ACQUISITION`
* `MERGER_BY_FORMATION`
* `DIVISION`
* `DIVISION_BY_ABSORPTION`
* `DIVISION_BY_FORMATION`
* `MIXED_DIVISION`
* `SETTLEMENT_BEFORE_BANKRUPTCY`
* `SETTLEMENT_AFTER_BANKRUPTCY`
* `TEMPORARY_DEFERMENT_OF_PAYMENT`
* `PERMANENT_DEFERMENT_OF_PAYMENT`
* `REVOCATION_OF_DEFERMENT`
* `END_OF_DEFERMENT`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE`
* `CLOSING_OF_BANKRUPTCY_PROCEDURE`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `DEFERMENT`
* `ENTITY_IDENTIFICATION`
* `STRIKING_OFF_FOLLOWING_CESSATION_IN_REGISTER_IN_THE_EEA`
* `REOPENING_LIQUIDATION`
* `REOPENING_DISOLUTION`
* `COMPULSORY_DISSOLUTION_OR_NULLIFICATION`
* `RECEIVER_APPOINTED`
* `VOLUNTARY_ARRANGEMENT`
* `CHANGED_COMPANY_TYPE`
* `DE_REGISTERED`
entityType can be either `LEGAL_PERSON` or `NATURAL_PERSON`
| Code | Description |
| -------- | ---------------------------------------------------------------------------------- |
| AGRICO | agricultural company |
| AUMUCO | autonomous municipal company |
| AUPRCO | autonomous provincial company |
| BRUSCR | brussels-capital region authorities |
| CITIES | cities and municipalities |
| CSUNCS | civil society as an unlimited liability and united cs |
| CSCOLS | civil society in the form of a collective society |
| CSLPS | civil society in the form of a limit partnership with shares |
| CSLLCS | civil society in the form of a limited liability cs |
| CSLPAR | civil society in the form of a limited partnership |
| CSPLLC | civil society in the form of a private limited liability company |
| CSPLCO | civil society in the form of a public limited company |
| CSAGCO | civil society in the form of an agricultural company |
| COOWN | co-ownership association |
| COMLCO | common law company |
| COFORM | company in formation |
| CAWOLP | company or association without legal personality |
| CONCOM | congolese company |
| CSOR | cooperative society (old regime) |
| CSPLOR | cooperative society governed by public law (old regime) |
| CSPL | cooperative society governed by public law |
| CSLLPS | cooperative society with limited liability (profit share) |
| CSLLSO | cooperative society with limited liability and a social objective |
| CSLLPP | cooperative society with limited liability governed by public law (profit share) |
| CSLLPL | cooperative society with limited liability governed by public law |
| CSLL | cooperative society with limited liability |
| CSULPS | cooperative society with unlimited liability (profit share) |
| CSULSO | cooperative society with unlimited liability and a social objective |
| CSULPP | cooperative society with unlimited liability governed by public law (profit share) |
| CSULPL | cooperative society with unlimited liability governed by public law |
| CSUL | cooperative society with unlimited liability |
| CS | cooperative society |
| CPASAS | cpas / ocmw association |
| CULT | cult |
| ECASBE | econ. assoc wo regist. seat but with est. unit in belgium |
| EIGSO | economic interest grouping with a social objective |
| EIG | economic interest grouping with registered seat in belgium |
| EEAWOH | europ. econ. assoc wo reg.seat but with est. unit in belgium |
| SE | european company (societas europaea) |
| SCE | european cooperative society |
| EEABE | european economic assoc with registered seat in belgium |
| EUPOLF | european political foundation |
| EUPOLP | european political party |
| EXPASS | expense association |
| FPPS | federal public planning service |
| FPS | federal public service |
| FLEMRC | flemish region and flemish community authorities |
| FLEMRC | flemish region and flemish community authority |
| FEPBE | foreign ent. with property in belgium (without legal pers.) |
| FEPIBLP | foreign entity with property in belgium (with legal personality) |
| FEWOUVAT | foreign entity without belgian establishment unit with vat representation |
| FORENT | foreign entity |
| FCOWHE | foreign listed company without belgian establishment unit |
| FPUORG | foreign or international public organisations |
| FRENCH | french community authorities |
| GPSO | general partnership with a social objective |
| GENPAR | general partnership |
| GERMAN | german-speaking community authorities |
| HEALTH | health fund / mutual health insurance / national union of health funds |
| HULPVZ | hulpverleningszone |
| INTERC | intercommunal |
| INTCO | internal company |
| INPASSPL | international non-profit association governed by public law |
| INPASS | international non-profit association |
| ISCORG | international scientific organisation under belgian law |
| LPPL | limited partnership governed by public law |
| LTDPRTN | limited partnership |
| LOCPOL | local police |
| MINMC | ministry for middle class |
| MINAGR | ministry of agriculture |
| MINECO | ministry of economic affairs |
| MINEMP | ministry of employment and labour |
| MINFIN | ministry of finance |
| MINFOR | ministry of foreign affairs |
| MINHAF | ministry of home affairs |
| MINJUS | ministry of justice |
| MINDEF | ministry of national defence |
| MINEDU | ministry of national education and culture |
| MINHEA | ministry of public health and family |
| MINSER | ministry of public service |
| MINRW | ministry of road works |
| MINSEA | ministry of self-employed and agriculture |
| MINSAH | ministry of social affair public health and environment |
| MINSWF | ministry of social welfare |
| MINBCR | ministry of the brussels-capital region |
| MINFLC | ministry of the flemish community |
| MINFRC | ministry of the french community |
| MINGSC | ministry of the german-speaking community |
| MINWAR | ministry of the walloon region |
| MINTIN | ministry of traffic and infrastructure |
| MIWOLP | miscellaneous without legal personality |
| MISC | miscellaneous |
| NPROFI | non-profit institution |
| NPROF | non-profit organisation |
| LTDPSO | ordinary limited partnership with a social objective |
| OLP | ordinary limited partnership |
| ORGPUP | organis. regist. with the public admin. pensions (finance) |
| NSSOLR | organisations registered through the onssapl |
| ORGONP | organisations registered with the o.n.p |
| OTHFS | other federal services |
| OTHISO | other institution with a social objective (public) |
| OTHER | other legal form |
| OTHPRI | other private organisation with legal personality |
| LTPSSO | partnership limited by shares with a social objective |
| PLTDSH | partnership limited by shares |
| PAWN | pawnshop |
| PENSIO | pension scheme organisation |
| POLDER | polders and water boards |
| PREZON | prezone |
| PFA | private foreign association with establishment in belgium |
| PFA | private foreign association with establishment unit |
| PFA | private foreign association with establishmen agenc office or branch in belgium |
| PRIVFO | private foundation |
| PLCPL | private limited company governed by public law |
| PLC | private limited company |
| PRLCSO | private limited liability company with a social objective |
| PLIMLC | private limited liability company |
| MUTINS | private mutual insurance fund |
| PROFCO | professional corporations - orders |
| PROFUN | professional union |
| PROJAS | project association |
| PROVAU | provincial authorities |
| PROVAU | provincial authority |
| PSOACT | pubic social action centre |
| PUBINS | public institution |
| PLCSO | public limited company with a social objective |
| PLIMCO | public limited company |
| MUTINS | public mutual insurance fund |
| PNPASS | public non-profit association |
| PUBLUF | public utility foundation |
| PUBLUT | public utility institution |
| REPRAS | representative association (flemish region) |
| SEPRAS | service provider association (flemish region) |
| SPRC | stat provinc regio community |
| TEMPAS | temporary association |
| TEMPCO | temporary company |
| SPRMIN | the services of the prime minister |
| TUNION | trade union |
| ULPCSO | unipersonal private limited liability company with a social objective |
| UNNSSO | unkown legal form (nsso) |
| UNLCC | unlawful commercial company |
| VATGR | vat-group |
| WALLRA | walloon region authorities |
| EMZ | sole proprietorship |
| Code | Description |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Organisme de placement collectif en valeurs mobilières sans personnalité morale |
| 1000 | Entrepreneur individuel |
| 2110 | Indivision entre personnes physiques |
| 2120 | Indivision avec personne morale |
| 2210 | Société créée de fait entre personnes physiques |
| 2220 | Société créée de fait avec personne morale |
| 2310 | Société en participation entre personnes physiques |
| 2320 | Société en participation avec personne morale |
| 2385 | Société en participation de professions libérales |
| 2400 | Fiducie |
| 2700 | Paroisse hors zone concordataire |
| 2800 | Assujetti unique à la TVA |
| 2900 | Autre groupement de droit privé non doté de la personnalité morale |
| 3110 | Représentation ou agence commerciale d'état ou organisme public étranger immatriculé au RCS |
| 3120 | Société commerciale étrangère immatriculée au RCS |
| 3205 | Organisation internationale |
| 3210 | État, collectivité ou établissement public étranger |
| 3220 | Société étrangère non immatriculée au RCS |
| 3290 | Autre personne morale de droit étranger |
| 4110 | Établissement public national à caractère industriel ou commercial doté d'un comptable public |
| 4120 | Établissement public national à caractère industriel ou commercial non doté d'un comptable public |
| 4130 | Exploitant public |
| 4140 | Établissement public local à caractère industriel ou commercial |
| 4150 | Régie d'une collectivité locale à caractère industriel ou commercial |
| 4160 | Institution Banque de France |
| 5191 | Société de caution mutuelle |
| 5192 | Société coopérative de banque populaire |
| 5193 | Caisse de crédit maritime mutuel |
| 5194 | Caisse (fédérale) de crédit mutuel |
| 5195 | Association coopérative inscrite (droit local Alsace Moselle) |
| 5196 | Caisse d'épargne et de prévoyance à forme coopérative |
| 5202 | Société en nom collectif |
| 5203 | Société en nom collectif coopérative |
| 5306 | Société en commandite simple |
| 5307 | Société en commandite simple coopérative |
| 5308 | Société en commandite par actions |
| 5309 | Société en commandite par actions coopérative |
| 5310 | Société en libre partenariat (SLP) |
| 5370 | Société de Participations Financières de Profession Libérale Société en commandite par actions (SPFPL SCA) |
| 5385 | Société d'exercice libéral en commandite par actions |
| 5410 | SARL nationale |
| 5415 | SARL d'économie mixte |
| 5422 | SARL immobilière pour le commerce et l'industrie (SICOMI) |
| 5426 | SARL immobilière de gestion |
| 5430 | SARL d'aménagement foncier et d'équipement rural (SAFER) |
| 5431 | SARL mixte d'intérêt agricole (SMIA) |
| 5432 | SARL d'intérêt collectif agricole (SICA) |
| 5442 | SARL d'attribution |
| 5443 | SARL coopérative de construction |
| 5451 | SARL coopérative de consommation |
| 5453 | SARL coopérative artisanale |
| 5454 | SARL coopérative d'intérêt maritime |
| 5455 | SARL coopérative de transport |
| 5458 | SARL coopérative de production (SCOP) |
| 5459 | SARL union de sociétés coopératives |
| 5460 | Autre SARL coopérative |
| 5470 | Société de Participations Financières de Profession Libérale Société à responsabilité limitée (SPFPL SARL) |
| 5485 | Société d'exercice libéral à responsabilité limitée |
| 5499 | Société à responsabilité limitée (sans autre indication) |
| 5505 | SA à participation ouvrière à conseil d'administration |
| 5510 | SA nationale à conseil d'administration |
| 5515 | SA d'économie mixte à conseil d'administration |
| 5520 | Fonds à forme sociétale à conseil d'administration |
| 5522 | SA immobilière pour le commerce et l'industrie (SICOMI) à conseil d'administration |
| 5525 | SA immobilière d'investissement à conseil d'administration |
| 5530 | SA d'aménagement foncier et d'équipement rural (SAFER) à conseil d'administration |
| 5531 | Société anonyme mixte d'intérêt agricole (SMIA) à conseil d'administration |
| 5532 | SA d'intérêt collectif agricole (SICA) à conseil d'administration |
| 5542 | SA d'attribution à conseil d'administration |
| 5543 | SA coopérative de construction à conseil d'administration |
| 5546 | SA de HLM à conseil d'administration |
| 5547 | SA coopérative de production de HLM à conseil d'administration |
| 5548 | SA de crédit immobilier à conseil d'administration |
| 5551 | SA coopérative de consommation à conseil d'administration |
| 5552 | SA coopérative de commerçants-détaillants à conseil d'administration |
| 5553 | SA coopérative artisanale à conseil d'administration |
| 5554 | SA coopérative (d'intérêt) maritime à conseil d'administration |
| 5555 | SA coopérative de transport à conseil d'administration |
| 5558 | SA coopérative de production (SCOP) à conseil d'administration |
| 5559 | SA union de sociétés coopératives à conseil d'administration |
| 5560 | Autre SA coopérative à conseil d'administration |
| 5570 | Société de Participations Financières de Profession Libérale Société anonyme à conseil d'administration (SPFPL SA à conseil d'administration) |
| 5585 | Société d'exercice libéral à forme anonyme à conseil d'administration |
| 5599 | SA à conseil d'administration (s.a.i.) |
| 5605 | SA à participation ouvrière à directoire |
| 5610 | SA nationale à directoire |
| 5615 | SA d'économie mixte à directoire |
| 5620 | Fonds à forme sociétale à directoire |
| 5622 | SA immobilière pour le commerce et l'industrie (SICOMI) à directoire |
| 5625 | SA immobilière d'investissement à directoire |
| 5630 | Safer anonyme à directoire |
| 5631 | SA mixte d'intérêt agricole (SMIA) |
| 5632 | SA d'intérêt collectif agricole (SICA) |
| 5642 | SA d'attribution à directoire |
| 5643 | SA coopérative de construction à directoire |
| 5646 | SA de HLM à directoire |
| 5647 | Société coopérative de production de HLM anonyme à directoire |
| 5648 | SA de crédit immobilier à directoire |
| 5651 | SA coopérative de consommation à directoire |
| 5652 | SA coopérative de commerçants-détaillants à directoire |
| 5653 | SA coopérative artisanale à directoire |
| 5654 | SA coopérative d'intérêt maritime à directoire |
| 5655 | SA coopérative de transport à directoire |
| 5658 | SA coopérative de production (SCOP) à directoire |
| 5659 | SA union de sociétés coopératives à directoire |
| 5660 | Autre SA coopérative à directoire |
| 5670 | Société de Participations Financières de Profession Libérale Société anonyme à Directoire (SPFPL SA à directoire) |
| 5685 | Société d'exercice libéral à forme anonyme à directoire |
| 5699 | SA à directoire (s.a.i.) |
| 5710 | SAS, société par actions simplifiée |
| 5770 | Société de Participations Financières de Profession Libérale Société par actions simplifiée (SPFPL SAS) |
| 5785 | Société d'exercice libéral par action simplifiée |
| 5800 | Société européenne |
| 6100 | Caisse d'Épargne et de Prévoyance |
| 6210 | Groupement européen d'intérêt économique (GEIE) |
| 6220 | Groupement d'intérêt économique (GIE) |
| 6316 | Coopérative d'utilisation de matériel agricole en commun (CUMA) |
| 6317 | Société coopérative agricole |
| 6318 | Union de sociétés coopératives agricoles |
| 6411 | Société d'assurance à forme mutuelle |
| 6511 | Sociétés Interprofessionnelles de Soins Ambulatoires |
| 6521 | Société civile de placement collectif immobilier (SCPI) |
| 6532 | Société civile d'intérêt collectif agricole (SICA) |
| 6533 | Groupement agricole d'exploitation en commun (GAEC) |
| 6534 | Groupement foncier agricole |
| 6535 | Groupement agricole foncier |
| 6536 | Groupement forestier |
| 6537 | Groupement pastoral |
| 6538 | Groupement foncier et rural |
| 6539 | Société civile foncière |
| 6540 | Société civile immobilière |
| 6541 | Société civile immobilière de construction-vente |
| 6542 | Société civile d'attribution |
| 6543 | Société civile coopérative de construction |
| 6544 | Société civile immobilière d' accession progressive à la propriété |
| 6551 | Société civile coopérative de consommation |
| 6554 | Société civile coopérative d'intérêt maritime |
| 6558 | Société civile coopérative entre médecins |
| 6560 | Autre société civile coopérative |
| 6561 | SCP d'avocats |
| 6562 | SCP d'avocats aux conseils |
| 6563 | SCP d'avoués d'appel |
| 6564 | SCP d'huissiers |
| 6565 | SCP de notaires |
| 6566 | SCP de commissaires-priseurs |
| 6567 | SCP de greffiers de tribunal de commerce |
| 6568 | SCP de conseils juridiques |
| 6569 | SCP de commissaires aux comptes |
| 6571 | SCP de médecins |
| 6572 | SCP de dentistes |
| 6573 | SCP d'infirmiers |
| 6574 | SCP de masseurs-kinésithérapeutes |
| 6575 | SCP de directeurs de laboratoire d'analyse médicale |
| 6576 | SCP de vétérinaires |
| 6577 | SCP de géomètres experts |
| 6578 | SCP d'architectes |
| 6585 | Autre société civile professionnelle |
| 6589 | Société civile de moyens |
| 6595 | Caisse locale de crédit mutuel |
| 6596 | Caisse de crédit agricole mutuel |
| 6597 | Société civile d'exploitation agricole |
| 6598 | Exploitation agricole à responsabilité limitée |
| 6599 | Autre société civile |
| 6901 | Autre personne de droit privé inscrite au registre du commerce et des sociétés |
| 7111 | Autorité constitutionnelle |
| 7112 | Autorité administrative ou publique indépendante |
| 7113 | Ministère |
| 7120 | Service central d'un ministère |
| 7150 | Service du ministère de la Défense |
| 7160 | Service déconcentré à compétence nationale d'un ministère (hors Défense) |
| 7171 | Service déconcentré de l'État à compétence (inter) régionale |
| 7172 | Service déconcentré de l'État à compétence (inter) départementale |
| 7179 | (Autre) Service déconcentré de l'État à compétence territoriale |
| 7190 | Ecole nationale non dotée de la personnalité morale |
| 7210 | Commune et commune nouvelle |
| 7220 | Département |
| 7225 | Collectivité et territoire d'Outre Mer |
| 7229 | (Autre) Collectivité territoriale |
| 7230 | Région |
| 7312 | Commune associée et commune déléguée |
| 7313 | Section de commune |
| 7314 | Ensemble urbain |
| 7321 | Association syndicale autorisée |
| 7322 | Association foncière urbaine |
| 7323 | Association foncière de remembrement |
| 7331 | Établissement public local d'enseignement |
| 7340 | Pôle métropolitain |
| 7341 | Secteur de commune |
| 7342 | District urbain |
| 7343 | Communauté urbaine |
| 7344 | Métropole |
| 7345 | Syndicat intercommunal à vocation multiple (SIVOM) |
| 7346 | Communauté de communes |
| 7347 | Communauté de villes |
| 7348 | Communauté d'agglomération |
| 7349 | Autre établissement public local de coopération non spécialisé ou entente |
| 7351 | Institution interdépartementale ou entente |
| 7352 | Institution interrégionale ou entente |
| 7353 | Syndicat intercommunal à vocation unique (SIVU) |
| 7354 | Syndicat mixte fermé |
| 7355 | Syndicat mixte ouvert |
| 7356 | Commission syndicale pour la gestion des biens indivis des communes |
| 7357 | Pôle d'équilibre territorial et rural (PETR) |
| 7361 | Centre communal d'action sociale |
| 7362 | Caisse des écoles |
| 7363 | Caisse de crédit municipal |
| 7364 | Établissement d'hospitalisation |
| 7365 | Syndicat inter hospitalier |
| 7366 | Établissement public local social et médico-social |
| 7367 | Centre Intercommunal d'action sociale (CIAS) |
| 7371 | Office public d'habitation à loyer modéré (OPHLM) |
| 7372 | Service départemental d'incendie et de secours (SDIS) |
| 7373 | Établissement public local culturel |
| 7378 | Régie d'une collectivité locale à caractère administratif |
| 7379 | (Autre) Établissement public administratif local |
| 7381 | Organisme consulaire |
| 7382 | Établissement public national ayant fonction d'administration centrale |
| 7383 | Établissement public national à caractère scientifique culturel et professionnel |
| 7384 | Autre établissement public national d'enseignement |
| 7385 | Autre établissement public national administratif à compétence territoriale limitée |
| 7389 | Établissement public national à caractère administratif |
| 7410 | Groupement d'intérêt public (GIP) |
| 7430 | Établissement public des cultes d'Alsace-Lorraine |
| 7450 | Etablissement public administratif, cercle et foyer dans les armées |
| 7470 | Groupement de coopération sanitaire à gestion publique |
| 7490 | Autre personne morale de droit administratif |
| 8110 | Régime général de la Sécurité Sociale |
| 8120 | Régime spécial de Sécurité Sociale |
| 8130 | Institution de retraite complémentaire |
| 8140 | Mutualité sociale agricole |
| 8150 | Régime maladie des non-salariés non agricoles |
| 8160 | Régime vieillesse ne dépendant pas du régime général de la Sécurité Sociale |
| 8170 | Régime d'assurance chômage |
| 8190 | Autre régime de prévoyance sociale |
| 8210 | Mutuelle |
| 8250 | Assurance mutuelle agricole |
| 8290 | Autre organisme mutualiste |
| 8310 | Comité social économique d’entreprise |
| 8311 | Comité social économique d'établissement |
| 8410 | Syndicat de salariés |
| 8420 | Syndicat patronal |
| 8450 | Ordre professionnel ou assimilé |
| 8470 | Centre technique industriel ou comité professionnel du développement économique |
| 8490 | Autre organisme professionnel |
| 8510 | Institution de prévoyance |
| 8520 | Institution de retraite supplémentaire |
| 9110 | Syndicat de copropriété |
| 9150 | Association syndicale libre |
| 9210 | Association non déclarée |
| 9220 | Association déclarée |
| 9221 | Association déclarée d'insertion par l'économique |
| 9222 | Association intermédiaire |
| 9223 | Groupement d'employeurs |
| 9224 | Association d'avocats à responsabilité professionnelle individuelle |
| 9230 | Association déclarée, reconnue d'utilité publique |
| 9240 | Congrégation |
| 9260 | Association de droit local (Bas-Rhin, Haut-Rhin et Moselle) |
| 9300 | Fondation |
| 9900 | Autre personne morale de droit privé |
| 9970 | Groupement de coopération sanitaire à gestion privée |
| Code | Description |
| ---- | -------------------------------------------------------- |
| BV | Besloten Vennootschap |
| VVE | Vereniging van Eigenaars |
| VOF | Vennootschap Onder firma |
| VER | Vereniging |
| ST | Stichting |
| COP | Coöperatie |
| KG | Kerkgenootschap |
| CV | Commanditaire Vennootschap |
| MA | Maatschap |
| NV | Naamloze Vennootschap |
| BR | Buitenlandse Rechtsvorm |
| OWM | Onderlinge Waarborg Maatschappij |
| RIO | Rechtsperoon in oprichting |
| RIO | Rechtspersoon in oprichting |
| PR | Publiekrechtelijke Rechtspersoon |
| SE | Europese naamloze vennootschap (SE) |
| OPR | Overige Privaatrechtelijke Rechtspersoon |
| EESV | Europees economisch samenwerkingsverband |
| EMZ | Eenmanszaak |
| SE | Europese naamloze vennootschap (SE) met gewone structuur |
| RED | Rederij |
'Do Not Call Me' flag
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
Common score is a score provided by CreditSafe that predicts the likelihood of a company becoming insolvent or bankrupt within the next 12 months
| Score | Description |
| ----- | -------------- |
| A | Very low risk |
| B | Low risk |
| C | Moderate risk |
| D | High risk |
| E | Very high risk |
This is the credit limit provided by CreditSafe. It is the recommended maximum amount of credit that can be safely extended to a company at one time.
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"vatNumber": "BE0770.493.071",
"registrationNumber": {
"type": "KBO",
"value": "0770493071"
},
"country": "BE",
"companyTypeCode": "PLC",
"legalStatus": "NORMAL_SITUATION",
"legalStatusSince": "2021-06-29T00:00:00.000Z",
"establishedSince": "2021-06-29T00:00:00.000Z",
"financialYear": {
"day": 31,
"month": 12
},
"isPrimary": true,
"name": "Bizzy AI",
"description": "Bizzy is a B2B intelligence platform that leverages AI to help users discover, qualify, and engage with companies efficiently, providing real-time insights and data integration.",
"phoneNumber": null,
"dncm": false,
"email": null,
"website": "https://bizzy.ai",
"balanceSheetEstimations": {
"legalEntityId": "1778186251",
"employeeBucket": "Bucket20_49",
"revenueBucket": "Bucket0_1M"
},
"naceCodes": [
{
"code": "62010",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "NSSO2008"
},
{
"code": "62020",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
},
{
"code": "62090",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
},
{
"code": "62100",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "NSSO2025"
},
{
"code": "62200",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "62900",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "70200",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "70220",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
}
],
"creditScore": {
"creditScore": 43,
"creditLimit": 500,
"commonScore": "C"
},
"language": "NL"
}
}
```
# Bulk Details
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/detailsBulk
POST /v2/legal-entities
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
## Response
The following fields can have a set of values:
legalStatus can be one of the following:
* `NORMAL_SITUATION`
* `LEGAL_CREATION`
* `EX_OFFICIO_LIQUIDATION_AFTER_TERM_EXPIRATION`
* `CESSATION_OF_ACTIVITIES_IN_COUNTRY`
* `VOLUNTARY_DISSOLUTIONVOLUNTARY_LIQUIDATION`
* `COMPULSORY_DISSOLUTION`
* `END_OF_DISSOLUTION`
* `START_OF_DISSOLUTION`
* `CESSATION_OF_ENTITY_WITHOUT_LEGAL_PERSONALITY`
* `CESSATIONTRANSFER_OF_REGISTERED_ENTITY_NATURAL_PERSON`
* `CESSATION_DURING_IDENTIFICATION`
* `CESSATION_OF_EDRL_OR_NON_EU_ENTITY`
* `SHARES_HELD_BY_SINGLE_SHAREHOLDER`
* `MERGER_BY_ACQUISITION`
* `MERGER_BY_FORMATION`
* `DIVISION`
* `DIVISION_BY_ABSORPTION`
* `DIVISION_BY_FORMATION`
* `MIXED_DIVISION`
* `SETTLEMENT_BEFORE_BANKRUPTCY`
* `SETTLEMENT_AFTER_BANKRUPTCY`
* `TEMPORARY_DEFERMENT_OF_PAYMENT`
* `PERMANENT_DEFERMENT_OF_PAYMENT`
* `REVOCATION_OF_DEFERMENT`
* `END_OF_DEFERMENT`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `OPENING_BANKRUPTCY_PROCEDURE`
* `CLOSING_OF_BANKRUPTCY_PROCEDURE`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_EXCUSABILITY`
* `CLOSURE_BANKRUPTCY_PROCEDURE_WITH_INEXCUSABILITY`
* `DEFERMENT`
* `ENTITY_IDENTIFICATION`
* `STRIKING_OFF_FOLLOWING_CESSATION_IN_REGISTER_IN_THE_EEA`
* `REOPENING_LIQUIDATION`
* `REOPENING_DISOLUTION`
* `COMPULSORY_DISSOLUTION_OR_NULLIFICATION`
* `RECEIVER_APPOINTED`
* `VOLUNTARY_ARRANGEMENT`
* `CHANGED_COMPANY_TYPE`
* `DE_REGISTERED`
entityType can be either `LEGAL_PERSON` or `NATURAL_PERSON`
| Code | Description |
| -------- | ---------------------------------------------------------------------------------- |
| AGRICO | agricultural company |
| AUMUCO | autonomous municipal company |
| AUPRCO | autonomous provincial company |
| BRUSCR | brussels-capital region authorities |
| CITIES | cities and municipalities |
| CSUNCS | civil society as an unlimited liability and united cs |
| CSCOLS | civil society in the form of a collective society |
| CSLPS | civil society in the form of a limit partnership with shares |
| CSLLCS | civil society in the form of a limited liability cs |
| CSLPAR | civil society in the form of a limited partnership |
| CSPLLC | civil society in the form of a private limited liability company |
| CSPLCO | civil society in the form of a public limited company |
| CSAGCO | civil society in the form of an agricultural company |
| COOWN | co-ownership association |
| COMLCO | common law company |
| COFORM | company in formation |
| CAWOLP | company or association without legal personality |
| CONCOM | congolese company |
| CSOR | cooperative society (old regime) |
| CSPLOR | cooperative society governed by public law (old regime) |
| CSPL | cooperative society governed by public law |
| CSLLPS | cooperative society with limited liability (profit share) |
| CSLLSO | cooperative society with limited liability and a social objective |
| CSLLPP | cooperative society with limited liability governed by public law (profit share) |
| CSLLPL | cooperative society with limited liability governed by public law |
| CSLL | cooperative society with limited liability |
| CSULPS | cooperative society with unlimited liability (profit share) |
| CSULSO | cooperative society with unlimited liability and a social objective |
| CSULPP | cooperative society with unlimited liability governed by public law (profit share) |
| CSULPL | cooperative society with unlimited liability governed by public law |
| CSUL | cooperative society with unlimited liability |
| CS | cooperative society |
| CPASAS | cpas / ocmw association |
| CULT | cult |
| ECASBE | econ. assoc wo regist. seat but with est. unit in belgium |
| EIGSO | economic interest grouping with a social objective |
| EIG | economic interest grouping with registered seat in belgium |
| EEAWOH | europ. econ. assoc wo reg.seat but with est. unit in belgium |
| SE | european company (societas europaea) |
| SCE | european cooperative society |
| EEABE | european economic assoc with registered seat in belgium |
| EUPOLF | european political foundation |
| EUPOLP | european political party |
| EXPASS | expense association |
| FPPS | federal public planning service |
| FPS | federal public service |
| FLEMRC | flemish region and flemish community authorities |
| FLEMRC | flemish region and flemish community authority |
| FEPBE | foreign ent. with property in belgium (without legal pers.) |
| FEPIBLP | foreign entity with property in belgium (with legal personality) |
| FEWOUVAT | foreign entity without belgian establishment unit with vat representation |
| FORENT | foreign entity |
| FCOWHE | foreign listed company without belgian establishment unit |
| FPUORG | foreign or international public organisations |
| FRENCH | french community authorities |
| GPSO | general partnership with a social objective |
| GENPAR | general partnership |
| GERMAN | german-speaking community authorities |
| HEALTH | health fund / mutual health insurance / national union of health funds |
| HULPVZ | hulpverleningszone |
| INTERC | intercommunal |
| INTCO | internal company |
| INPASSPL | international non-profit association governed by public law |
| INPASS | international non-profit association |
| ISCORG | international scientific organisation under belgian law |
| LPPL | limited partnership governed by public law |
| LTDPRTN | limited partnership |
| LOCPOL | local police |
| MINMC | ministry for middle class |
| MINAGR | ministry of agriculture |
| MINECO | ministry of economic affairs |
| MINEMP | ministry of employment and labour |
| MINFIN | ministry of finance |
| MINFOR | ministry of foreign affairs |
| MINHAF | ministry of home affairs |
| MINJUS | ministry of justice |
| MINDEF | ministry of national defence |
| MINEDU | ministry of national education and culture |
| MINHEA | ministry of public health and family |
| MINSER | ministry of public service |
| MINRW | ministry of road works |
| MINSEA | ministry of self-employed and agriculture |
| MINSAH | ministry of social affair public health and environment |
| MINSWF | ministry of social welfare |
| MINBCR | ministry of the brussels-capital region |
| MINFLC | ministry of the flemish community |
| MINFRC | ministry of the french community |
| MINGSC | ministry of the german-speaking community |
| MINWAR | ministry of the walloon region |
| MINTIN | ministry of traffic and infrastructure |
| MIWOLP | miscellaneous without legal personality |
| MISC | miscellaneous |
| NPROFI | non-profit institution |
| NPROF | non-profit organisation |
| LTDPSO | ordinary limited partnership with a social objective |
| OLP | ordinary limited partnership |
| ORGPUP | organis. regist. with the public admin. pensions (finance) |
| NSSOLR | organisations registered through the onssapl |
| ORGONP | organisations registered with the o.n.p |
| OTHFS | other federal services |
| OTHISO | other institution with a social objective (public) |
| OTHER | other legal form |
| OTHPRI | other private organisation with legal personality |
| LTPSSO | partnership limited by shares with a social objective |
| PLTDSH | partnership limited by shares |
| PAWN | pawnshop |
| PENSIO | pension scheme organisation |
| POLDER | polders and water boards |
| PREZON | prezone |
| PFA | private foreign association with establishment in belgium |
| PFA | private foreign association with establishment unit |
| PFA | private foreign association with establishmen agenc office or branch in belgium |
| PRIVFO | private foundation |
| PLCPL | private limited company governed by public law |
| PLC | private limited company |
| PRLCSO | private limited liability company with a social objective |
| PLIMLC | private limited liability company |
| MUTINS | private mutual insurance fund |
| PROFCO | professional corporations - orders |
| PROFUN | professional union |
| PROJAS | project association |
| PROVAU | provincial authorities |
| PROVAU | provincial authority |
| PSOACT | pubic social action centre |
| PUBINS | public institution |
| PLCSO | public limited company with a social objective |
| PLIMCO | public limited company |
| MUTINS | public mutual insurance fund |
| PNPASS | public non-profit association |
| PUBLUF | public utility foundation |
| PUBLUT | public utility institution |
| REPRAS | representative association (flemish region) |
| SEPRAS | service provider association (flemish region) |
| SPRC | stat provinc regio community |
| TEMPAS | temporary association |
| TEMPCO | temporary company |
| SPRMIN | the services of the prime minister |
| TUNION | trade union |
| ULPCSO | unipersonal private limited liability company with a social objective |
| UNNSSO | unkown legal form (nsso) |
| UNLCC | unlawful commercial company |
| VATGR | vat-group |
| WALLRA | walloon region authorities |
| EMZ | sole proprietorship |
| Code | Description |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Organisme de placement collectif en valeurs mobilières sans personnalité morale |
| 1000 | Entrepreneur individuel |
| 2110 | Indivision entre personnes physiques |
| 2120 | Indivision avec personne morale |
| 2210 | Société créée de fait entre personnes physiques |
| 2220 | Société créée de fait avec personne morale |
| 2310 | Société en participation entre personnes physiques |
| 2320 | Société en participation avec personne morale |
| 2385 | Société en participation de professions libérales |
| 2400 | Fiducie |
| 2700 | Paroisse hors zone concordataire |
| 2800 | Assujetti unique à la TVA |
| 2900 | Autre groupement de droit privé non doté de la personnalité morale |
| 3110 | Représentation ou agence commerciale d'état ou organisme public étranger immatriculé au RCS |
| 3120 | Société commerciale étrangère immatriculée au RCS |
| 3205 | Organisation internationale |
| 3210 | État, collectivité ou établissement public étranger |
| 3220 | Société étrangère non immatriculée au RCS |
| 3290 | Autre personne morale de droit étranger |
| 4110 | Établissement public national à caractère industriel ou commercial doté d'un comptable public |
| 4120 | Établissement public national à caractère industriel ou commercial non doté d'un comptable public |
| 4130 | Exploitant public |
| 4140 | Établissement public local à caractère industriel ou commercial |
| 4150 | Régie d'une collectivité locale à caractère industriel ou commercial |
| 4160 | Institution Banque de France |
| 5191 | Société de caution mutuelle |
| 5192 | Société coopérative de banque populaire |
| 5193 | Caisse de crédit maritime mutuel |
| 5194 | Caisse (fédérale) de crédit mutuel |
| 5195 | Association coopérative inscrite (droit local Alsace Moselle) |
| 5196 | Caisse d'épargne et de prévoyance à forme coopérative |
| 5202 | Société en nom collectif |
| 5203 | Société en nom collectif coopérative |
| 5306 | Société en commandite simple |
| 5307 | Société en commandite simple coopérative |
| 5308 | Société en commandite par actions |
| 5309 | Société en commandite par actions coopérative |
| 5310 | Société en libre partenariat (SLP) |
| 5370 | Société de Participations Financières de Profession Libérale Société en commandite par actions (SPFPL SCA) |
| 5385 | Société d'exercice libéral en commandite par actions |
| 5410 | SARL nationale |
| 5415 | SARL d'économie mixte |
| 5422 | SARL immobilière pour le commerce et l'industrie (SICOMI) |
| 5426 | SARL immobilière de gestion |
| 5430 | SARL d'aménagement foncier et d'équipement rural (SAFER) |
| 5431 | SARL mixte d'intérêt agricole (SMIA) |
| 5432 | SARL d'intérêt collectif agricole (SICA) |
| 5442 | SARL d'attribution |
| 5443 | SARL coopérative de construction |
| 5451 | SARL coopérative de consommation |
| 5453 | SARL coopérative artisanale |
| 5454 | SARL coopérative d'intérêt maritime |
| 5455 | SARL coopérative de transport |
| 5458 | SARL coopérative de production (SCOP) |
| 5459 | SARL union de sociétés coopératives |
| 5460 | Autre SARL coopérative |
| 5470 | Société de Participations Financières de Profession Libérale Société à responsabilité limitée (SPFPL SARL) |
| 5485 | Société d'exercice libéral à responsabilité limitée |
| 5499 | Société à responsabilité limitée (sans autre indication) |
| 5505 | SA à participation ouvrière à conseil d'administration |
| 5510 | SA nationale à conseil d'administration |
| 5515 | SA d'économie mixte à conseil d'administration |
| 5520 | Fonds à forme sociétale à conseil d'administration |
| 5522 | SA immobilière pour le commerce et l'industrie (SICOMI) à conseil d'administration |
| 5525 | SA immobilière d'investissement à conseil d'administration |
| 5530 | SA d'aménagement foncier et d'équipement rural (SAFER) à conseil d'administration |
| 5531 | Société anonyme mixte d'intérêt agricole (SMIA) à conseil d'administration |
| 5532 | SA d'intérêt collectif agricole (SICA) à conseil d'administration |
| 5542 | SA d'attribution à conseil d'administration |
| 5543 | SA coopérative de construction à conseil d'administration |
| 5546 | SA de HLM à conseil d'administration |
| 5547 | SA coopérative de production de HLM à conseil d'administration |
| 5548 | SA de crédit immobilier à conseil d'administration |
| 5551 | SA coopérative de consommation à conseil d'administration |
| 5552 | SA coopérative de commerçants-détaillants à conseil d'administration |
| 5553 | SA coopérative artisanale à conseil d'administration |
| 5554 | SA coopérative (d'intérêt) maritime à conseil d'administration |
| 5555 | SA coopérative de transport à conseil d'administration |
| 5558 | SA coopérative de production (SCOP) à conseil d'administration |
| 5559 | SA union de sociétés coopératives à conseil d'administration |
| 5560 | Autre SA coopérative à conseil d'administration |
| 5570 | Société de Participations Financières de Profession Libérale Société anonyme à conseil d'administration (SPFPL SA à conseil d'administration) |
| 5585 | Société d'exercice libéral à forme anonyme à conseil d'administration |
| 5599 | SA à conseil d'administration (s.a.i.) |
| 5605 | SA à participation ouvrière à directoire |
| 5610 | SA nationale à directoire |
| 5615 | SA d'économie mixte à directoire |
| 5620 | Fonds à forme sociétale à directoire |
| 5622 | SA immobilière pour le commerce et l'industrie (SICOMI) à directoire |
| 5625 | SA immobilière d'investissement à directoire |
| 5630 | Safer anonyme à directoire |
| 5631 | SA mixte d'intérêt agricole (SMIA) |
| 5632 | SA d'intérêt collectif agricole (SICA) |
| 5642 | SA d'attribution à directoire |
| 5643 | SA coopérative de construction à directoire |
| 5646 | SA de HLM à directoire |
| 5647 | Société coopérative de production de HLM anonyme à directoire |
| 5648 | SA de crédit immobilier à directoire |
| 5651 | SA coopérative de consommation à directoire |
| 5652 | SA coopérative de commerçants-détaillants à directoire |
| 5653 | SA coopérative artisanale à directoire |
| 5654 | SA coopérative d'intérêt maritime à directoire |
| 5655 | SA coopérative de transport à directoire |
| 5658 | SA coopérative de production (SCOP) à directoire |
| 5659 | SA union de sociétés coopératives à directoire |
| 5660 | Autre SA coopérative à directoire |
| 5670 | Société de Participations Financières de Profession Libérale Société anonyme à Directoire (SPFPL SA à directoire) |
| 5685 | Société d'exercice libéral à forme anonyme à directoire |
| 5699 | SA à directoire (s.a.i.) |
| 5710 | SAS, société par actions simplifiée |
| 5770 | Société de Participations Financières de Profession Libérale Société par actions simplifiée (SPFPL SAS) |
| 5785 | Société d'exercice libéral par action simplifiée |
| 5800 | Société européenne |
| 6100 | Caisse d'Épargne et de Prévoyance |
| 6210 | Groupement européen d'intérêt économique (GEIE) |
| 6220 | Groupement d'intérêt économique (GIE) |
| 6316 | Coopérative d'utilisation de matériel agricole en commun (CUMA) |
| 6317 | Société coopérative agricole |
| 6318 | Union de sociétés coopératives agricoles |
| 6411 | Société d'assurance à forme mutuelle |
| 6511 | Sociétés Interprofessionnelles de Soins Ambulatoires |
| 6521 | Société civile de placement collectif immobilier (SCPI) |
| 6532 | Société civile d'intérêt collectif agricole (SICA) |
| 6533 | Groupement agricole d'exploitation en commun (GAEC) |
| 6534 | Groupement foncier agricole |
| 6535 | Groupement agricole foncier |
| 6536 | Groupement forestier |
| 6537 | Groupement pastoral |
| 6538 | Groupement foncier et rural |
| 6539 | Société civile foncière |
| 6540 | Société civile immobilière |
| 6541 | Société civile immobilière de construction-vente |
| 6542 | Société civile d'attribution |
| 6543 | Société civile coopérative de construction |
| 6544 | Société civile immobilière d' accession progressive à la propriété |
| 6551 | Société civile coopérative de consommation |
| 6554 | Société civile coopérative d'intérêt maritime |
| 6558 | Société civile coopérative entre médecins |
| 6560 | Autre société civile coopérative |
| 6561 | SCP d'avocats |
| 6562 | SCP d'avocats aux conseils |
| 6563 | SCP d'avoués d'appel |
| 6564 | SCP d'huissiers |
| 6565 | SCP de notaires |
| 6566 | SCP de commissaires-priseurs |
| 6567 | SCP de greffiers de tribunal de commerce |
| 6568 | SCP de conseils juridiques |
| 6569 | SCP de commissaires aux comptes |
| 6571 | SCP de médecins |
| 6572 | SCP de dentistes |
| 6573 | SCP d'infirmiers |
| 6574 | SCP de masseurs-kinésithérapeutes |
| 6575 | SCP de directeurs de laboratoire d'analyse médicale |
| 6576 | SCP de vétérinaires |
| 6577 | SCP de géomètres experts |
| 6578 | SCP d'architectes |
| 6585 | Autre société civile professionnelle |
| 6589 | Société civile de moyens |
| 6595 | Caisse locale de crédit mutuel |
| 6596 | Caisse de crédit agricole mutuel |
| 6597 | Société civile d'exploitation agricole |
| 6598 | Exploitation agricole à responsabilité limitée |
| 6599 | Autre société civile |
| 6901 | Autre personne de droit privé inscrite au registre du commerce et des sociétés |
| 7111 | Autorité constitutionnelle |
| 7112 | Autorité administrative ou publique indépendante |
| 7113 | Ministère |
| 7120 | Service central d'un ministère |
| 7150 | Service du ministère de la Défense |
| 7160 | Service déconcentré à compétence nationale d'un ministère (hors Défense) |
| 7171 | Service déconcentré de l'État à compétence (inter) régionale |
| 7172 | Service déconcentré de l'État à compétence (inter) départementale |
| 7179 | (Autre) Service déconcentré de l'État à compétence territoriale |
| 7190 | Ecole nationale non dotée de la personnalité morale |
| 7210 | Commune et commune nouvelle |
| 7220 | Département |
| 7225 | Collectivité et territoire d'Outre Mer |
| 7229 | (Autre) Collectivité territoriale |
| 7230 | Région |
| 7312 | Commune associée et commune déléguée |
| 7313 | Section de commune |
| 7314 | Ensemble urbain |
| 7321 | Association syndicale autorisée |
| 7322 | Association foncière urbaine |
| 7323 | Association foncière de remembrement |
| 7331 | Établissement public local d'enseignement |
| 7340 | Pôle métropolitain |
| 7341 | Secteur de commune |
| 7342 | District urbain |
| 7343 | Communauté urbaine |
| 7344 | Métropole |
| 7345 | Syndicat intercommunal à vocation multiple (SIVOM) |
| 7346 | Communauté de communes |
| 7347 | Communauté de villes |
| 7348 | Communauté d'agglomération |
| 7349 | Autre établissement public local de coopération non spécialisé ou entente |
| 7351 | Institution interdépartementale ou entente |
| 7352 | Institution interrégionale ou entente |
| 7353 | Syndicat intercommunal à vocation unique (SIVU) |
| 7354 | Syndicat mixte fermé |
| 7355 | Syndicat mixte ouvert |
| 7356 | Commission syndicale pour la gestion des biens indivis des communes |
| 7357 | Pôle d'équilibre territorial et rural (PETR) |
| 7361 | Centre communal d'action sociale |
| 7362 | Caisse des écoles |
| 7363 | Caisse de crédit municipal |
| 7364 | Établissement d'hospitalisation |
| 7365 | Syndicat inter hospitalier |
| 7366 | Établissement public local social et médico-social |
| 7367 | Centre Intercommunal d'action sociale (CIAS) |
| 7371 | Office public d'habitation à loyer modéré (OPHLM) |
| 7372 | Service départemental d'incendie et de secours (SDIS) |
| 7373 | Établissement public local culturel |
| 7378 | Régie d'une collectivité locale à caractère administratif |
| 7379 | (Autre) Établissement public administratif local |
| 7381 | Organisme consulaire |
| 7382 | Établissement public national ayant fonction d'administration centrale |
| 7383 | Établissement public national à caractère scientifique culturel et professionnel |
| 7384 | Autre établissement public national d'enseignement |
| 7385 | Autre établissement public national administratif à compétence territoriale limitée |
| 7389 | Établissement public national à caractère administratif |
| 7410 | Groupement d'intérêt public (GIP) |
| 7430 | Établissement public des cultes d'Alsace-Lorraine |
| 7450 | Etablissement public administratif, cercle et foyer dans les armées |
| 7470 | Groupement de coopération sanitaire à gestion publique |
| 7490 | Autre personne morale de droit administratif |
| 8110 | Régime général de la Sécurité Sociale |
| 8120 | Régime spécial de Sécurité Sociale |
| 8130 | Institution de retraite complémentaire |
| 8140 | Mutualité sociale agricole |
| 8150 | Régime maladie des non-salariés non agricoles |
| 8160 | Régime vieillesse ne dépendant pas du régime général de la Sécurité Sociale |
| 8170 | Régime d'assurance chômage |
| 8190 | Autre régime de prévoyance sociale |
| 8210 | Mutuelle |
| 8250 | Assurance mutuelle agricole |
| 8290 | Autre organisme mutualiste |
| 8310 | Comité social économique d’entreprise |
| 8311 | Comité social économique d'établissement |
| 8410 | Syndicat de salariés |
| 8420 | Syndicat patronal |
| 8450 | Ordre professionnel ou assimilé |
| 8470 | Centre technique industriel ou comité professionnel du développement économique |
| 8490 | Autre organisme professionnel |
| 8510 | Institution de prévoyance |
| 8520 | Institution de retraite supplémentaire |
| 9110 | Syndicat de copropriété |
| 9150 | Association syndicale libre |
| 9210 | Association non déclarée |
| 9220 | Association déclarée |
| 9221 | Association déclarée d'insertion par l'économique |
| 9222 | Association intermédiaire |
| 9223 | Groupement d'employeurs |
| 9224 | Association d'avocats à responsabilité professionnelle individuelle |
| 9230 | Association déclarée, reconnue d'utilité publique |
| 9240 | Congrégation |
| 9260 | Association de droit local (Bas-Rhin, Haut-Rhin et Moselle) |
| 9300 | Fondation |
| 9900 | Autre personne morale de droit privé |
| 9970 | Groupement de coopération sanitaire à gestion privée |
| Code | Description |
| ---- | -------------------------------------------------------- |
| BV | Besloten Vennootschap |
| VVE | Vereniging van Eigenaars |
| VOF | Vennootschap Onder firma |
| VER | Vereniging |
| ST | Stichting |
| COP | Coöperatie |
| KG | Kerkgenootschap |
| CV | Commanditaire Vennootschap |
| MA | Maatschap |
| NV | Naamloze Vennootschap |
| BR | Buitenlandse Rechtsvorm |
| OWM | Onderlinge Waarborg Maatschappij |
| RIO | Rechtsperoon in oprichting |
| RIO | Rechtspersoon in oprichting |
| PR | Publiekrechtelijke Rechtspersoon |
| SE | Europese naamloze vennootschap (SE) |
| OPR | Overige Privaatrechtelijke Rechtspersoon |
| EESV | Europees economisch samenwerkingsverband |
| EMZ | Eenmanszaak |
| SE | Europese naamloze vennootschap (SE) met gewone structuur |
| RED | Rederij |
'Do Not Call Me' flag
revenueEstimations will be one of the following:
| Bucket | Description |
| --------------- | -------------------------------------------- |
| Bucket0\_1M | revenue 0M to 1M (included) |
| Bucket1\_2M | revenue 1M to 2M (included) |
| Bucket2\_5M | revenue 2M to 5M (included) |
| Bucket5\_10M | revenue > 5M (excluded) to 10M (included) |
| Bucket10\_50M | revenue > 10M (excluded) to 50M (included) |
| Bucket50\_100M | revenue > 50M (excluded) to 100M (included) |
| Bucket100\_500M | revenue > 100M (excluded) to 500M (included) |
| BucketAbove500M | revenue > 500M (excluded) |
These estimations work in the same bucket system as revenueEstimations
Common score is a score provided by CreditSafe that predicts the likelihood of a company becoming insolvent or bankrupt within the next 12 months
| Score | Description |
| ----- | -------------- |
| A | Very low risk |
| B | Low risk |
| C | Moderate risk |
| D | High risk |
| E | Very high risk |
This is the credit limit provided by CreditSafe. It is the recommended maximum amount of credit that can be safely extended to a company at one time.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"vatNumber": "BE0770.493.071",
"registrationNumber": {
"type": "KBO",
"value": "0770493071"
},
"country": "BE",
"companyTypeCode": "PLC",
"legalStatus": "NORMAL_SITUATION",
"legalStatusSince": "2021-06-29T00:00:00.000Z",
"establishedSince": "2021-06-29T00:00:00.000Z",
"financialYear": {
"day": 31,
"month": 12
},
"isPrimary": true,
"name": "Bizzy AI",
"description": "Bizzy is a B2B intelligence platform that leverages AI to help users discover, qualify, and engage with companies efficiently, providing real-time insights and data integration.",
"phoneNumber": null,
"dncm": false,
"email": null,
"website": "https://bizzy.ai",
"balanceSheetEstimations": {
"legalEntityId": "1778186251",
"employeeBucket": "Bucket20_49",
"revenueBucket": "Bucket0_1M"
},
"naceCodes": [
{
"code": "62010",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "NSSO2008"
},
{
"code": "62020",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
},
{
"code": "62090",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
},
{
"code": "62100",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "NSSO2025"
},
{
"code": "62200",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "62900",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "70200",
"version": "nacebel2025",
"isMainActivity": false,
"fullVersion": "VAT2025"
},
{
"code": "70220",
"version": "nacebel2008",
"isMainActivity": false,
"fullVersion": "VAT2008"
}
],
"creditScore": {
"creditScore": 43,
"creditLimit": 500,
"commonScore": "C"
},
"language": "EN"
},
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"message": "Legal entity not found"
}
]
```
# Directors
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/directors
GET /v2/legal-entities/{legalEntityId}/directors
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip
You can query on name.
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"person": {
"contactId": "1086914623",
"firstName": "Lorenz",
"lastName": "Bogaert"
},
"function": "PERMANENT_REPRESENTATIVE",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1481690419",
"firstName": "Filip",
"lastName": "Van Innis"
},
"function": "PERMANENT_REPRESENTATIVE",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1086914623",
"firstName": "Lorenz",
"lastName": "Bogaert"
},
"function": "DIRECTOR",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1481690419",
"firstName": "Filip",
"lastName": "Van Innis"
},
"function": "DIRECTOR",
"since": "2025-05-16",
"until": null
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 16
}
}
```
# Bulk Directors
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/directorsBulk
POST /v2/legal-entities/directors
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
Number of items to return per page. (max 500)
Number of items to skip
You can query on name.
## Response
The same limit and offset are shared over all legal entities. `limit` may not exceed 100, and `legalEntities.length x limit` may not exceed 500.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"person": {
"contactId": "1086914623",
"firstName": "Lorenz",
"lastName": "Bogaert"
},
"function": "PERMANENT_REPRESENTATIVE",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1481690419",
"firstName": "Filip",
"lastName": "Van Innis"
},
"function": "PERMANENT_REPRESENTATIVE",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1086914623",
"firstName": "Lorenz",
"lastName": "Bogaert"
},
"function": "DIRECTOR",
"since": "2025-05-16",
"until": null
},
{
"person": {
"contactId": "1481690419",
"firstName": "Filip",
"lastName": "Van Innis"
},
"function": "DIRECTOR",
"since": "2025-05-16",
"until": null
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 16
},
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"pagination": null,
"message": "Legal entity not found"
}
]
```
# Documents
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/documents
GET /v2/legal-entities/{legalEntityId}/documents
Document `url` values are normalized to a full URL (documents sourced from NBB are returned as a signed URL). No documents are omitted from the response.
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"id": "69094085",
"internalId": "BE-25335726-2025-06-05",
"date": "2025-06-05",
"title": "OFFICIËLE DOCUMENTEN",
"url": "https://www.ejustice.just.fgov.be/document/123456.pdf",
"source": "SourcesBeEjustice",
"types": [
"ANNUAL_ACCOUNTS"
]
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Bulk Documents
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/documentsBulk
POST /v2/legal-entities/documents
Document `url` values are normalized to a full URL (documents sourced from NBB are returned as a signed URL). No documents are omitted from the response.
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
Number of items to return per page. (max 500)
Number of items to skip
## Response
The same limit and offset are shared over all legal entities. `limit` may not exceed 100, and `legalEntities.length x limit` may not exceed 500.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"id": "69094085",
"internalId": "BE-25335726-2025-06-05",
"date": "2025-06-05",
"title": "OFFICIËLE DOCUMENTEN",
"url": "https://www.ejustice.just.fgov.be/document/123456.pdf",
"source": "SourcesBeEjustice",
"types": [
"ANNUAL_ACCOUNTS"
]
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
},
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"pagination": null,
"message": "Legal entity not found"
}
]
```
# Establishments
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/establishments
GET /v2/legal-entities/{legalEntityId}/establishments
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"establishments": [
{
"id": "617935963",
"name": "Bizzy AI",
"address": {
"number": "5",
"street": "Dok-Noord",
"country": "BE",
"locality": "Ghent",
"postalCode": "9000"
},
"establishmentId": "2697485893",
"latitude": 51.0659,
"longitude": 3.7337,
"language": "NL",
"source": "SourcesBeKboCsv",
"admins": {
"admin1": "Flanders",
"admin2": "East Flanders",
"admin3": "Ghent"
}
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Bulk Establishments
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/establishmentsBulk
POST /v2/legal-entities/establishments
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
Number of items to return per page. (max 500)
Number of items to skip
## Response
The same limit and offset are shared over all legal entities. `limit` may not exceed 100, and `legalEntities.length x limit` may not exceed 500.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"establishments": [
{
"id": "617935963",
"name": "Bizzy AI",
"address": {
"number": "5",
"street": "Dok-Noord",
"country": "BE",
"locality": "Ghent",
"postalCode": "9000"
},
"establishmentId": "2697485893",
"latitude": 51.0659,
"longitude": 3.7337,
"language": "NL",
"source": "SourcesBeKboCsv",
"admins": {
"admin1": "Flanders",
"admin2": "East Flanders",
"admin3": "Ghent"
}
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
},
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"pagination": null,
"message": "Legal entity not found"
}
]
```
# Financials
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/financials
GET /v2/legal-entities/{legalEntityId}/financials
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
#### Query
Number of most recent financial years to return.
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"startDate": "2024-01-01",
"endDate": "2024-12-31",
"dateReceived": "2025-07-28",
"healthIndicator": 7,
"jointCommitteeCodes": [],
"profitability": {
"revenue": null,
"grossMargin": -6490.95,
"ebitda": -1674040.12,
"ebit": -2005417.93,
"netProfit": -2091791.18
},
"liquidity": {
"cash": 839561.33,
"cashFlow": -1759580.29,
"netWorkingCapital": -452639.45,
"netWorkingCapitalRequirement": -1100126.39,
"currentRatio": 0.7625,
"quickRatio": 1.347
},
"solvency": {
"totalAssets": 2282863.55,
"equity": -1976758.42,
"capital": null,
"retainedEarnings": -3300214.42,
"debt": 4259621.97,
"longTermDebt": 2353407.75,
"longTermDebtFinancial": 2353407.75,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 1017763.8,
"shortTermDebtFinancial": 192074.39,
"shortTermDebtAccountsPayable": 525293.41
},
"people": {
"employees": 28,
"newHires": 18,
"employeeMaleRatio": 0.8571,
"employeeFemaleRatio": 0.1429
}
},
{
"startDate": "2023-01-01",
"endDate": "2023-12-31",
"dateReceived": "2024-07-31",
"healthIndicator": 5,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": -157493.98,
"ebitda": -721635.55,
"ebit": -909762.24,
"netProfit": -924861.06
},
"liquidity": {
"cash": 486301.02,
"cashFlow": -736314.45,
"netWorkingCapital": 13795.96,
"netWorkingCapitalRequirement": -454370.47,
"currentRatio": 1.0196,
"quickRatio": 1.6408
},
"solvency": {
"totalAssets": 1198129.04,
"equity": 115032.76,
"capital": null,
"retainedEarnings": -1208423.24,
"debt": 1083096.28,
"longTermDebt": 379351.41,
"longTermDebtFinancial": 379351.41,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 404044.38,
"shortTermDebtFinancial": 18134.59,
"shortTermDebtAccountsPayable": 158076.92
},
"people": {
"employees": 12,
"newHires": 6,
"employeeMaleRatio": 0.9167,
"employeeFemaleRatio": 0.0833
}
},
{
"startDate": "2021-06-29",
"endDate": "2022-12-31",
"dateReceived": "2023-08-03",
"healthIndicator": 8,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": 165086.63,
"ebitda": -186249.28,
"ebit": -280667.61,
"netProfit": -283562.18
},
"liquidity": {
"cash": 898378.68,
"cashFlow": -188584.41,
"netWorkingCapital": 758619.72,
"netWorkingCapitalRequirement": -133652.28,
"currentRatio": 5.4031,
"quickRatio": 5.4511
},
"solvency": {
"totalAssets": 1259395.25,
"equity": 1039893.82,
"capital": null,
"retainedEarnings": -283562.18,
"debt": 219501.43,
"longTermDebt": 47209.12,
"longTermDebtFinancial": 47209.12,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 168577.31,
"shortTermDebtFinancial": 6106.68,
"shortTermDebtAccountsPayable": 44652.51
},
"people": {
"employees": 6,
"newHires": 15,
"employeeMaleRatio": 0.8333,
"employeeFemaleRatio": 0.1667
}
}
],
"range": 4
}
```
# Bulk Financials
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/financialsBulk
POST /v2/legal-entities/financials
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
Number of most recent financial years to return. Shared over all legal entities.
## Response
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": [
{
"startDate": "2024-01-01",
"endDate": "2024-12-31",
"dateReceived": "2025-07-28",
"healthIndicator": 7,
"jointCommitteeCodes": [],
"profitability": {
"revenue": null,
"grossMargin": -6490.95,
"ebitda": -1674040.12,
"ebit": -2005417.93,
"netProfit": -2091791.18
},
"liquidity": {
"cash": 839561.33,
"cashFlow": -1759580.29,
"netWorkingCapital": -452639.45,
"netWorkingCapitalRequirement": -1100126.39,
"currentRatio": 0.7625,
"quickRatio": 1.347
},
"solvency": {
"totalAssets": 2282863.55,
"equity": -1976758.42,
"capital": null,
"retainedEarnings": -3300214.42,
"debt": 4259621.97,
"longTermDebt": 2353407.75,
"longTermDebtFinancial": 2353407.75,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 1017763.8,
"shortTermDebtFinancial": 192074.39,
"shortTermDebtAccountsPayable": 525293.41
},
"people": {
"employees": 28,
"newHires": 18,
"employeeMaleRatio": 0.8571,
"employeeFemaleRatio": 0.1429
}
},
{
"startDate": "2023-01-01",
"endDate": "2023-12-31",
"dateReceived": "2024-07-31",
"healthIndicator": 5,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": -157493.98,
"ebitda": -721635.55,
"ebit": -909762.24,
"netProfit": -924861.06
},
"liquidity": {
"cash": 486301.02,
"cashFlow": -736314.45,
"netWorkingCapital": 13795.96,
"netWorkingCapitalRequirement": -454370.47,
"currentRatio": 1.0196,
"quickRatio": 1.6408
},
"solvency": {
"totalAssets": 1198129.04,
"equity": 115032.76,
"capital": null,
"retainedEarnings": -1208423.24,
"debt": 1083096.28,
"longTermDebt": 379351.41,
"longTermDebtFinancial": 379351.41,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 404044.38,
"shortTermDebtFinancial": 18134.59,
"shortTermDebtAccountsPayable": 158076.92
},
"people": {
"employees": 12,
"newHires": 6,
"employeeMaleRatio": 0.9167,
"employeeFemaleRatio": 0.0833
}
},
{
"startDate": "2021-06-29",
"endDate": "2022-12-31",
"dateReceived": "2023-08-03",
"healthIndicator": 8,
"jointCommitteeCodes": [
"200"
],
"profitability": {
"revenue": null,
"grossMargin": 165086.63,
"ebitda": -186249.28,
"ebit": -280667.61,
"netProfit": -283562.18
},
"liquidity": {
"cash": 898378.68,
"cashFlow": -188584.41,
"netWorkingCapital": 758619.72,
"netWorkingCapitalRequirement": -133652.28,
"currentRatio": 5.4031,
"quickRatio": 5.4511
},
"solvency": {
"totalAssets": 1259395.25,
"equity": 1039893.82,
"capital": null,
"retainedEarnings": -283562.18,
"debt": 219501.43,
"longTermDebt": 47209.12,
"longTermDebtFinancial": 47209.12,
"longTermDebtAccountsPayable": 0,
"shortTermDebt": 168577.31,
"shortTermDebtFinancial": 6106.68,
"shortTermDebtAccountsPayable": 44652.51
},
"people": {
"employees": 6,
"newHires": 15,
"employeeMaleRatio": 0.8333,
"employeeFemaleRatio": 0.1667
}
}
],
"range": 4,
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"range": null,
"message": "Legal entity not found"
}
]
```
# Ownership
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/ownership
GET /v2/legal-entities/{legalEntityId}/ownership
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"shareholders": [
{
"legalEntity": null,
"person": null,
"function": {
"type": "SHAREHOLDER",
"shares": 6400,
"percentage": 0.0157,
"since": "2023-12-31",
"until": null,
"status": "ACTIVE",
"moneyContribution": null
}
}
],
"investments": [],
"mandates": [
{
"legalEntity": {
"type": "SUPPORTED",
"legalEntityIdentifier": {
"legalEntityId": "0123456789",
"countryCode": "BE",
"name": "LEGALE ENTITEIT OOST-VLAANDEREN",
"isPrimary": false
}
},
"person": {
"contactId": "1234567890",
"firstName": "John",
"lastName": "Doe"
},
"function": {
"type": "PERMANENT_REPRESENTATIVE",
"shares": null,
"percentage": null,
"since": "2025-06-04",
"until": null,
"status": "ACTIVE",
"moneyContribution": null
}
}
],
"founders": [
{
"legalEntity": null,
"person": {
"contactId": "1234567890",
"firstName": "John",
"lastName": "Doe"
},
"function": {
"type": "FOUNDER",
"shares": 37500,
"percentage": null,
"since": "2021-06-29",
"until": null,
"status": "ACTIVE",
"moneyContribution": 37500
}
},
],
"absoluteParent": null,
"group": {
"company": {
"type": "SUPPORTED",
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
}
},
"shares": null,
"percentage": null,
"level": 0,
"daughters": []
}
}
}
```
# Bulk Ownership
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/ownershipBulk
POST /v2/legal-entities/ownership
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"shareholders": [
{
"legalEntity": null,
"person": null,
"function": {
"type": "SHAREHOLDER",
"shares": 6400,
"percentage": 0.0157,
"since": "2023-12-31",
"until": null,
"status": "ACTIVE",
"moneyContribution": null
}
}
],
"investments": [],
"mandates": [
{
"legalEntity": {
"type": "SUPPORTED",
"legalEntityIdentifier": {
"legalEntityId": "0123456789",
"countryCode": "BE",
"name": "LEGALE ENTITEIT OOST-VLAANDEREN",
"isPrimary": false
}
},
"person": {
"contactId": "1234567890",
"firstName": "John",
"lastName": "Doe"
},
"function": {
"type": "PERMANENT_REPRESENTATIVE",
"shares": null,
"percentage": null,
"since": "2025-06-04",
"until": null,
"status": "ACTIVE",
"moneyContribution": null
}
}
],
"founders": [
{
"legalEntity": null,
"person": {
"contactId": "1234567890",
"firstName": "John",
"lastName": "Doe"
},
"function": {
"type": "FOUNDER",
"shares": 37500,
"percentage": null,
"since": "2021-06-29",
"until": null,
"status": "ACTIVE",
"moneyContribution": 37500
}
},
],
"absoluteParent": null,
"group": {
"company": {
"type": "SUPPORTED",
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
}
},
"shares": null,
"percentage": null,
"level": 0,
"daughters": []
}
},
"message": null
},
{ // Example error
"legalEntityIdentifier": {
"legalEntityId": "123456789"
},
"data": null,
"message": "Legal entity not found"
}
]
```
# Updates
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/updates
GET /v2/legal-entities/{legalEntityId}/updates
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated legalEntityId returned by the company legal entities endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
```json Response - 200 theme={null}
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"updates": [
{
"id": "1479881766",
"type": "GROSS_MARGIN_GROWTH",
"title": "Gross margin grew by 96%",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "1554091785",
"type": "PUBLISHED_FINANCIALS",
"title": "Financials were published for 2024",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "1095951900",
"type": "HEALTHDROP",
"title": "Health increased by 2",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "628737772",
"type": "PEOPLE_LEFT",
"title": "David Du Pré, Lorenz Bogaert, Nicolas Van Eenaeme and Toon Coppens left their role as Director",
"time": "2025-06-09",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 18
}
}
```
# Bulk Updates
Source: https://docs.bizzy.ai/api-reference/v2/legalEntity/updatesBulk
POST /v2/legal-entities/updates
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Body
Obfuscated legalEntityId returned by the company legal entities endpoint.
You can request up to 100 legal entities at once.
Number of items to return per page. (max 500)
Number of items to skip.
## Response
The same limit and offset are shared over all legal entities. `limit` may not exceed 100, and `legalEntities.length x limit` may not exceed 500.
```json Response - 200 theme={null}
[
{
"legalEntityIdentifier": {
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
},
"data": {
"updates": [
{
"id": "1479881766",
"type": "GROSS_MARGIN_GROWTH",
"title": "Gross margin grew by 96%",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "1554091785",
"type": "PUBLISHED_FINANCIALS",
"title": "Financials were published for 2024",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "1095951900",
"type": "HEALTHDROP",
"title": "Health increased by 2",
"time": "2025-07-28",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
},
{
"id": "628737772",
"type": "PEOPLE_LEFT",
"title": "David Du Pré, Lorenz Bogaert, Nicolas Van Eenaeme and Toon Coppens left their role as Director",
"time": "2025-06-09",
"sourceUrl": null,
"sourceType": null,
"status": "ACTIVE"
}
]
},
"pagination": {
"limit": 4,
"offset": 0,
"total": 18
},
"message": null
},
{
"legalEntityIdentifier": {
"legalEntityId": "12345678"
},
"data": null,
"pagination": null,
"message": "Legal entity not found"
}
]
```
# Add items
Source: https://docs.bizzy.ai/api-reference/v2/lists/add-items
PUT /v2/lists/{listId}/results
Adds items to a list. The shape of each item in the `items` array must match the list's
`objectType`. Sending the wrong shape (e.g. a contact item to a company list) returns
`400`. You can add up to **100 items** per request.
## Request
#### Path
Obfuscated listId returned by the overview endpoint.
#### Body
Up to 100 items to add. The item shape depends on the list's `objectType`:
* **COMPANY** — `{ "countryCode": "BE", "companyId": "1778186251" }`
* **LEGAL\_ENTITY** — `{ "legalEntityId": "998877", "countryCode": "BE" }` (`countryCode` is optional)
* **CONTACT** — `{ "company": { "countryCode": "BE", "companyId": "1778186251" }, "contactIdentifier": { "contactId": "123456" } }`
```json Body (COMPANY list) theme={null}
{
"items": [
{ "countryCode": "BE", "companyId": "1778186251" }
]
}
```
## Response
`true` when at least one item was added successfully.
Items that could not be added, each with the original `item` and a `message` explaining
why (e.g. `Company not found`, `Invalid contactId`).
```json Response - 200 theme={null}
{
"success": true,
"failed": [],
"message": "Successfully added 1 item(s) to the list."
}
```
# Details
Source: https://docs.bizzy.ai/api-reference/v2/lists/details
GET /v2/lists/{listId}
## Request
#### Path
Obfuscated listId returned by the overview endpoint.
## Response
One of `COMPANY`, `LEGAL_ENTITY` or `CONTACT`.
One of `MANUAL` or `CRM_MIRRORED`.
One of `LIST`, `BOARD` or `MAP`.
The status buckets configured for this list. Each status has a `key`, `label`, `color`,
`position` and an `isArchivedBucket` flag.
```json Response - 200 theme={null}
{
"data": {
"listId": "420055",
"name": "Example List",
"objectType": "COMPANY",
"statusMode": "MANUAL",
"defaultView": "LIST",
"statuses": [
{
"key": "new",
"label": "New",
"color": "#3F8EFF",
"position": 0,
"isArchivedBucket": false
}
],
"createdAt": "2026-05-20T08:45:00.000Z",
"updatedAt": "2026-06-18T10:30:00.000Z"
}
}
```
# Export
Source: https://docs.bizzy.ai/api-reference/v2/lists/export
POST /v2/lists/{listId}/export
Queues an export of a list's active items. The export runs asynchronously; use the
returned `exportId` with the [Exports API](/api-reference/v2/exports/status) to track its
status and download the result.
## Request
#### Path
Obfuscated listId returned by the overview endpoint.
#### Body
Output format. One of `CSV` or `XLSX`.
Email enrichment level. One of `NONE`, `VERIFIED` or `CATCH_ALL`.
Whether to enrich mobile phone numbers.
The columns to include in the export. When omitted, a default set is used. Invalid
columns are rejected by the export service.
Maximum number of contacts to include per company (positive integer).
```json Body theme={null}
{
"format": "CSV",
"emailEnrichment": "VERIFIED",
"phoneEnrichment": false,
"columns": ["name", "vatNumber", "website"]
}
```
## Response
```json Response - 200 theme={null}
{
"success": true,
"exportId": "8817263",
"message": "Export queued successfully"
}
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/lists/introduction
With our Lists API, you can manage the lists in your workspace: fetch your team's lists,
read their items, add new items, and queue an export of a list.
## Object types
Every list is **homogeneous** — it holds a single type of object, described by its
`objectType`:
* `COMPANY` — companies
* `LEGAL_ENTITY` — legal entities
* `CONTACT` — contacts (a contact is always tied to a company)
The `objectType` determines the shape of the items returned by the results endpoint and
the shape accepted when adding items.
## Identifiers
List IDs (`listId`) are obfuscated. You obtain them from the [overview](/api-reference/v2/lists/overview)
endpoint and pass them back to the other endpoints.
## Authorization
The Public API token is team-scoped. Every request only operates on lists that belong to
your team; requesting a list from another team returns `404`.
# Overview
Source: https://docs.bizzy.ai/api-reference/v2/lists/overview
GET /v2/lists
## Request
#### Query
Filter lists by object type. One of `COMPANY`, `LEGAL_ENTITY` or `CONTACT`. If omitted,
lists of all types are returned.
Number of items to return per page. (max 500)
Number of items to skip.
## Response
One of `COMPANY`, `LEGAL_ENTITY` or `CONTACT`.
One of `MANUAL` or `CRM_MIRRORED`.
```json Response - 200 theme={null}
{
"data": [
{
"listId": "420055",
"name": "Example List",
"objectType": "COMPANY",
"statusMode": "MANUAL",
"itemCount": 15,
"createdAt": "2026-05-20T08:45:00.000Z",
"updatedAt": "2026-06-18T10:30:00.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 12
}
}
```
# Results
Source: https://docs.bizzy.ai/api-reference/v2/lists/results
GET /v2/lists/{listId}/results
Returns the items of a list. The shape of each item in `data` depends on the list's
`objectType` (`COMPANY`, `LEGAL_ENTITY` or `CONTACT`).
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated listId returned by the overview endpoint.
#### Query
When `true`, items in an archived status bucket are also returned.
Number of items to return per page. (max 500)
Number of items to skip.
## Response
The `identifier` describes the list; `data` holds the items.
```json Response - 200 (COMPANY list) theme={null}
{
"listIdentifier": {
"listId": "420055",
"name": "Example List",
"objectType": "COMPANY"
},
"data": [
{
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 15
}
}
```
```json Response - 200 (LEGAL_ENTITY list) theme={null}
{
"listIdentifier": {
"listId": "531166",
"name": "Legal entities",
"objectType": "LEGAL_ENTITY"
},
"data": [
{
"legalEntityId": "998877",
"countryCode": "BE",
"name": "Bizzy NV",
"isPrimary": true
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 3
}
}
```
```json Response - 200 (CONTACT list) theme={null}
{
"listIdentifier": {
"listId": "642277",
"name": "Contacts",
"objectType": "CONTACT"
},
"data": [
{
"jobTitle": "CEO",
"contactIdentifier": {
"contactId": "123456",
"firstName": "Jane",
"lastName": "Doe"
},
"company": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
}
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 42
}
}
```
# Postman collection
Source: https://docs.bizzy.ai/api-reference/v2/postman-collection
[https://drive.google.com/file/d/1QoYrkfcOrr8H0fiuv3-xdFAPBdOoLaEr/view](https://drive.google.com/file/d/1QoYrkfcOrr8H0fiuv3-xdFAPBdOoLaEr/view)
# Rate Limiting
Source: https://docs.bizzy.ai/api-reference/v2/rateLimiting
V2 endpoints are limited to 500 requests per minute, counted per API key (the `Authorization` header).
If you exceed this limit, you'll receive a `429 Too Many Requests` response.
# Details
Source: https://docs.bizzy.ai/api-reference/v2/saved-searches/details
GET /v2/saved-searches/{savedSearchId}
Returns the definition of a saved search, including its configured columns and sort order.
## Request
#### Path
Obfuscated savedSearchId returned by the overview endpoint.
## Response
One of `COMPANY`, `LEGAL_ENTITY` or `EMPLOYEES`.
The columns configured for this saved search.
The sort order configured for this saved search.
```json Response - 200 theme={null}
{
"data": {
"savedSearchId": "774411",
"name": "Belgian SaaS companies",
"searchType": "COMPANY",
"columns": ["name", "vatNumber", "website"],
"sort": {
"field": "name",
"direction": "ASC"
},
"createdAt": "2026-05-20T08:45:00.000Z",
"updatedAt": "2026-06-18T10:30:00.000Z"
}
}
```
# Introduction
Source: https://docs.bizzy.ai/api-reference/v2/saved-searches/introduction
With our Saved Searches API, you can fetch your team's saved searches and execute them
live to retrieve their current results.
## Search types
Each saved search targets a single entity type, described by its `searchType`:
* `COMPANY` — returns companies
* `LEGAL_ENTITY` — returns legal entities
* `EMPLOYEES` — returns contacts
The `searchType` determines the shape of the items returned by the results endpoint.
## Live execution
The [results](/api-reference/v2/saved-searches/results) endpoint runs the saved search's
stored filters against the latest data every time it is called — results are never cached.
## Identifiers
Saved search IDs (`savedSearchId`) are obfuscated. You obtain them from the
[overview](/api-reference/v2/saved-searches/overview) endpoint.
## Authorization
The Public API token is team-scoped. Every request only operates on saved searches that
belong to your team; requesting one from another team returns `404`.
# Overview
Source: https://docs.bizzy.ai/api-reference/v2/saved-searches/overview
GET /v2/saved-searches
## Request
#### Query
Filter saved searches by name.
Number of items to return per page. (max 500)
Number of items to skip.
## Response
One of `COMPANY`, `LEGAL_ENTITY` or `EMPLOYEES`.
```json Response - 200 theme={null}
{
"data": [
{
"savedSearchId": "774411",
"name": "Belgian SaaS companies",
"searchType": "COMPANY",
"createdAt": "2026-05-20T08:45:00.000Z",
"updatedAt": "2026-06-18T10:30:00.000Z"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 7
}
}
```
# Results
Source: https://docs.bizzy.ai/api-reference/v2/saved-searches/results
GET /v2/saved-searches/{savedSearchId}/results
Executes the saved search against the latest data and returns a page of results. The shape
of each item in `data` depends on the saved search's `searchType` (`COMPANY`,
`LEGAL_ENTITY` or `EMPLOYEES`).
## Request
#### Header
* NL: Dutch - FR: French - EN: English
#### Path
Obfuscated savedSearchId returned by the overview endpoint.
#### Query
Number of items to return per page. (max 500)
Number of items to skip.
## Response
The `identifier` describes the saved search; `data` holds the matching entities.
```json Response - 200 (COMPANY search) theme={null}
{
"savedSearchIdentifier": {
"savedSearchId": "774411",
"name": "Belgian SaaS companies",
"searchType": "COMPANY"
},
"data": [
{
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 128
}
}
```
```json Response - 200 (LEGAL_ENTITY search) theme={null}
{
"savedSearchIdentifier": {
"savedSearchId": "531166",
"name": "Belgian legal entities",
"searchType": "LEGAL_ENTITY"
},
"data": [
{
"legalEntityId": "998877",
"countryCode": "BE",
"name": "Bizzy NV",
"isPrimary": true
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 3
}
}
```
```json Response - 200 (EMPLOYEES search) theme={null}
{
"savedSearchIdentifier": {
"savedSearchId": "882200",
"name": "Belgian sales leaders",
"searchType": "EMPLOYEES"
},
"data": [
{
"jobTitle": "CEO",
"contactIdentifier": {
"contactId": "123456",
"firstName": "Jane",
"lastName": "Doe"
},
"company": {
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy"
}
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 54
}
}
```
# Search Companies
Source: https://docs.bizzy.ai/api-reference/v2/search/companies
GET /v2/search/companies
## Request
Provide **exactly one** of `q` (name search) or `vat` (VAT-number search). Supplying neither or both returns a `400`. An empty value counts as absent, so `?q=&vat=BE0400378485` is treated as a VAT search.
Search is free — it does not spend credits.
#### Query
The name of the company you want to query, up to 20 characters. Mutually exclusive with `vat`.
The VAT number of the company you want to query, up to 30 characters. Mutually exclusive with `q`. Accepts either a formatted (`0400.378.485`) or bare (`BE0400378485`) value — it is normalized across all supported registry/VAT formats before matching.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries). If omitted, the search runs across all supported countries.
Number of items to return per page. (max 500)
Number of items to skip. (max 9500)
```json Response - 200 theme={null}
{
"data": [
{
"countryCode": "BE",
"companyId": "1778186251",
"name": "Bizzy AI"
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Search Legal Entities
Source: https://docs.bizzy.ai/api-reference/v2/search/legal-entities
GET /v2/search/legal-entities
## Request
Provide **exactly one** of `q` (name search) or `vat` (VAT-number search). Supplying neither or both returns a `400`. An empty value counts as absent, so `?q=&vat=BE0400378485` is treated as a VAT search.
Search is free — it does not spend credits.
#### Query
The name of the legal entity you want to query, up to 20 characters. Mutually exclusive with `vat`.
The VAT number of the legal entity you want to query, up to 30 characters. Mutually exclusive with `q`. Accepts either a formatted (`0400.378.485`) or bare (`BE0400378485`) value — it is normalized across all supported registry/VAT formats before matching.
Any supported country code — see [Supported countries](/api-reference/v2/supported-countries). If omitted, the search runs across all supported countries.
Number of items to return per page. (max 500)
Number of items to skip. (max 9500)
```json Response - 200 theme={null}
{
"data": [
{
"legalEntityId": "1778186251",
"countryCode": "BE",
"name": "Bizzy AI",
"isPrimary": true
}
],
"pagination": {
"limit": 4,
"offset": 0,
"total": 1
}
}
```
# Supported countries
Source: https://docs.bizzy.ai/api-reference/v2/supported-countries
The **V2 API** supports the following country codes. Any endpoint that takes a
`countryCode` accepts one of these values — any other value is rejected.
| | | | | |
| --------------- | ---------------- | ------------------- | ------------- | ------------- |
| `AT` Austria | `BE` Belgium | `CH` Switzerland | `DE` Germany | `DK` Denmark |
| `FI` Finland | `FR` France | `GB` United Kingdom | `IE` Ireland | `IT` Italy |
| `LU` Luxembourg | `NL` Netherlands | `NO` Norway | `PL` Poland | `SE` Sweden |
| `ES` Spain | `PT` Portugal | `CZ` Czechia | `UA` Ukraine | `BG` Bulgaria |
| `HR` Croatia | `CY` Cyprus | `EE` Estonia | `GR` Greece | `HU` Hungary |
| `LT` Lithuania | `MT` Malta | `RO` Romania | `SK` Slovakia | `SI` Slovenia |
| `LV` Latvia | `IS` Iceland | `RS` Serbia | | |