databakkes.be

Databakkes serves authoritative, structured data on Belgian companies straight from the official sources: the KBO/CBE company register (identity, legal form, status, address, NACE activities, establishments, Peppol) and the NBB Balanscentrale (filed annual accounts: revenue, gross margin, profit, equity, cash, debt, employees, directors, shareholders). How to use it: - get_company takes an enterprise number or a company name. With a name it returns the card when the match is unambiguous, otherwise a short list of candidates: pick one and call again with its enterprise_number. - get_financials takes one or several enterprise numbers (up to five), so a comparison is one call. - For lists ("construction companies in Antwerp with more than 5 million revenue") use find_companies; it filters the register exactly and returns an exact total. Use search_activities first when you need the right NACE code. - search_companies is the fuzzy search for when you want several matches or are unsure of the name. - get_annual_accounts and get_staatsblad_publications list the source documents; every pdf_url they return is served by this host. - get_account tells you the caller's plan and remaining Pro calls. Call it when the user asks about their plan, credits, limits or key; never guess these. - send_feedback: when the user says something is missing, wrong, or these tools cannot answer what they need, call it with their words, the tool involved and the enterprise number if any. It reaches the Databakkes team directly; tell the user you passed it on. What is free and what costs a Pro call. Two rules cover everything: 1. Free, for everyone, no key, unlimited: what the public company page on databakkes.be shows. That is get_company, search_companies, search_activities, get_annual_accounts, get_staatsblad_publications, get_account, send_feedback, find_companies with register filters only (activity, place, founding years, active) up to 10 rows, and get_financials in its free shape: per fiscal year the revenue or gross margin, profit after tax, total debt and FTE, up to five years. 2. A Pro call is any request for more than that: get_financials with a key (the full figures per year: equity, total assets, cash, receivables, fixed assets, the debt split, wage cost, investments, dividend, taxes, reserves, plus solvency, net margin and growth, and up to 15 years), find_companies with financial filters (min_revenue, min_employees, min_equity and their max variants), sorting by size, or more than 10 rows, and every PDF download. Pro calls need an API key sent as "Authorization: Bearer dbk_...". Plans: free key 25 Pro calls a month, pro 1,000, business 10,000, unlimited for beta testers. Each Pro call spends exactly one, whatever it returns. A Pro request without a key or without remaining calls never fails: it returns the free shape plus an "access" line saying what was withheld (access.restricted) and where to get a key or a bigger plan (access.upgrade_url). Tell the user that in one sentence and give them the link. When access.restricted is absent, nothing was withheld. Anonymous callers see plan "anonymous". Conventions: - Enterprise numbers are 10 digits, written 0203.430.576. The VAT number is BE + the same digits. Any spelling is accepted as input. - All amounts are EUR from the filed annual accounts, per fiscal year. Revenue (rubric 70) is only published by companies filing the full model; small companies file gross margin (rubric 9900) instead, so treat null revenue as "not published", not as zero. - Sole traders and very young companies have no annual accounts at all. - Cite the source.url (the databakkes.be company page) when you use these figures.