Bulk Financials

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

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v1/companies/financials', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v1/companies/financials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizzy.ai/v1/companies/financials"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v1/companies/financials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

POST

companies

financials

Bulk Financials

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

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v1/companies/financials', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v1/companies/financials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizzy.ai/v1/companies/financials"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v1/companies/financials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

Request

string

default:"EN"

NL: Dutch - FR: French - EN: English

Body

array

Show company properties

string

required

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

string

required

countryCode can be either BE, NL or FR

You can request up to 100 companies at once.

number

default:"4"

Number of items to return per page. (max 500)

number

default:"0"

Number of items to skip.

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

Getting Started

V2 API

V1 API

Bulk Financials

Request

Header

Body

​Request

​Header

​Body

Request

Header

Body