GET
/
v1
/
companies
/
{countryCode}
/
{companyNumber}
Details
curl --request GET \
  --url https://api.bizzy.ai/v1/companies/{countryCode}/{companyNumber} \
  --header 'Authorization: Bearer <token>'
{
  "identifier": {
    "country": "BE",
    "companyNumber": "770493071",
    "name": "Bizzy Fintech",
    "place": "Gent"
  },
  "data": {
    "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 Fintech",
    "tradeNames": [
      {
        "name": "Bizzy Fintech"
      },
      {
        "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
  }
}

​
Request

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

​
Path

​
countryCode
string
required
countryCode can be either BE, NL or FR
​
companyNumber
string
required
  • 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: 
{
  "identifier": {
    "country": "BE",
    "companyNumber": "770493071",
    "name": "Bizzy Fintech",
    "place": "Gent"
  },
  "data": {
    "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 Fintech",
    "tradeNames": [
      {
        "name": "Bizzy Fintech"
      },
      {
        "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
string
status can be either ACTIVE or INACTIVE
​
legalStatus
string
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
string
entityType can be either LEGAL_PERSON or NATURAL_PERSON
​
companyTypeCode
string
​
revenueEstimations
string
revenueEstimations will be one of the following:
BucketDescription
Bucket0_1Mrevenue 0M to 1M (included)
Bucket1_2Mrevenue 1M to 2M (included)
Bucket2_5Mrevenue 2M to 5M (included)
Bucket5_10Mrevenue > 5M (excluded) to 10M (included)
Bucket10_50Mrevenue > 10M (excluded) to 50M (included)
Bucket50_100Mrevenue > 50M (excluded) to 100M (included)
Bucket100_500Mrevenue > 100M (excluded) to 500M (included)
BucketAbove500Mrevenue > 500M (excluded)
​
employeeEstimations
string
These estimations work in the same bucket system as revenueEstimations
​
commonScore
string
Common score is a score provided by CreditSafe that predicts the likelihood of a company becoming insolvent or bankrupt within the next 12 months
ScoreDescription
AVery low risk
BLow risk
CModerate risk
DHigh risk
EVery high risk
​
creditLimit
string
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.
​
contact
object