Reference

Reference from cached spec. Start the API on 127.0.0.1:8000 for the live one.

GET/v1/account

Balance and counters for your key. Free.

Example

{
  "object": "account",
  "key_prefix": "ak_live_xXTW",
  "balance_cents": 490,
  "searches_used_week": 12,
  "search_quota_week": 50,
  "unlocks_today": 1,
  "unlock_cap_day": 200
}

GET/v1/companies

Search companies by name, domain, postcode, province, NACE, legal form or date. Returns stubs, included in your key.

name	in	type	required	description
domain	query	string \| null	no	Web domain, e.g. farys.be. Returns verified matches with a verdict.
name	query	string \| null	no	Company name, fuzzy, ranked by similarity.
postal_code	query	string \| null	no	Four-digit postcode of the registered seat.
province	query	string \| null	no	Province name in Dutch, French or English, e.g. antwerpen.
incorporated_after	query	string \| null	no	ISO date, inclusive.
incorporated_before	query	string \| null	no	ISO date, exclusive.
activity	query	string \| null	no	One exact NACE-BEL code, e.g. 62010.
activity_scheme	query	string \| null	no	nace_bel_2003, nace_bel_2008 or nace_bel_2025 (default).
legal_form	query	string \| null	no	Abbreviation such as BV or the numeric code.
status	query	string \| null	no	active (default), dissolved or all.
include_rejected	query	boolean	no	Domain search only: also return hits whose verdict is not match.
lang	query	string (nl \| fr \| en)	no	Label language for activities and legal forms.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [
    {
      "match": {
        "on": "domain",
        "confidence": 1,
        "evidence": [
          "label_in_name"
        ],
        "verdict": "match"
      },
      "company": {
        "object": "company_stub",
        "id": "be:0200068636",
        "name": "Farys",
        "legal_form": {
          "scheme": "be_kbo_juridical_form",
          "code": "417",
          "label": "Opdrachthoudende vereniging"
        },
        "status": {
          "normalized": "active",
          "local": "AC"
        },
        "incorporated_on": "1923-02-16",
        "registered_address": {
          "postal_code": "9000",
          "locality": "Gent",
          "admin_areas": {
            "province": "Oost-Vlaanderen",
            "region": "Vlaanderen"
          }
        },
        "activities": [
          {
            "scheme": "nace_bel_2008",
            "code": "36000",
            "primary": true
          }
        ],
        "links": {
          "self": "/v1/companies/be:0200068636"
        }
      }
    }
  ],
  "has_more": false
}

GET/v1/companies/{company_id}

One company. The first fetch costs €0.10 and unlocks it for 30 days.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
lang	query	string (nl \| fr \| en)	no	Label language for activities and legal forms.
expand[]	query	string[]	no	Inline the first page of establishments, relationships, financials, publications or events.

Example

{
  "id": "be:0200068636",
  "object": "company",
  "jurisdiction": "be",
  "identifiers": [
    {
      "scheme": "be_enterprise_number",
      "value": "0200068636",
      "primary": true
    },
    {
      "scheme": "eu_vat",
      "value": "BE0200068636",
      "primary": false
    }
  ],
  "name": "Farys",
  "legal_form": {
    "scheme": "be_kbo_juridical_form",
    "code": "417",
    "label": "Opdrachthoudende vereniging"
  },
  "status": {
    "normalized": "active",
    "local": "AC"
  },
  "incorporated_on": "1923-02-16",
  "registered_address": {
    "street": "Stropstraat",
    "house_number": "1",
    "postal_code": "9000",
    "locality": "Gent",
    "admin_areas": {
      "province": "Oost-Vlaanderen",
      "region": "Vlaanderen"
    },
    "country": "BE"
  },
  "activities": [
    {
      "scheme": "nace_bel_2008",
      "code": "36000",
      "label": "Winning, behandeling en distributie van water",
      "primary": true
    }
  ],
  "contact": {
    "website": "https://www.farys.be"
  },
  "web": {
    "domains": [
      {
        "domain": "farys.be",
        "link": "operator",
        "confidence": 1,
        "evidence": [
          "label_in_name"
        ]
      }
    ],
    "linkedin": {
      "url": "https://www.linkedin.com/company/farys",
      "confidence": 0.9
    }
  },
  "summary": {
    "establishment_count": 61,
    "active_relationship_count": 0,
    "latest_fiscal_year": 2025,
    "employee_estimate": {
      "value": 974,
      "band": "500-999",
      "source": "be_nbb",
      "fiscal_year": 2025
    }
  },
  "incorporation": {
    "published_on": "2026-10-28",
    "purpose": "Het openen en uitbaten van koffiebars",
    "purpose_lang": "nl",
    "capital_eur": 5000,
    "founders_count": 2,
    "starter_type": "starter",
    "premises": "Ledeberg, Gent",
    "activities": [
      {
        "scheme": "nace_bel_2025",
        "code": "56301",
        "label": "Cafés en bars",
        "primary": true,
        "source": "kbo"
      },
      {
        "scheme": "nace_bel_2025",
        "code": "5630",
        "label": "Cafés en andere drankgelegenheden",
        "primary": false,
        "source": "deed",
        "confidence": 0.6
      }
    ],
    "source": {
      "name": "be_staatsblad",
      "ref": "2026-123456",
      "url": "/tsv_pdf/2026/10/28/2026123456.pdf",
      "published_on": "2026-10-28"
    }
  },
  "links": {
    "establishments": "/v1/companies/be:0200068636/establishments",
    "relationships": "/v1/companies/be:0200068636/relationships",
    "financials": "/v1/companies/be:0200068636/financials",
    "publications": "/v1/companies/be:0200068636/publications",
    "events": "/v1/companies/be:0200068636/events",
    "graph": "/v1/companies/be:0200068636/graph"
  }
}

GET/v1/companies/{company_id}/establishments

The establishments of a company. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
active	query	boolean	no	Only current rows (default true).
lang	query	string (nl \| fr \| en)	no	Label language for activities and legal forms.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [],
  "has_more": false
}

GET/v1/companies/{company_id}/relationships

Directors, shareholders, auditors and parents, legal persons only. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
type	query	string \| null	no	Comma list of director, managing_director, shareholder, auditor, parent, liquidator.
direction	query	string (in \| out \| both)	no	in: who holds a role in this company; out: where this company holds one; both (default).
active	query	boolean	no	Only current rows (default true).
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [],
  "has_more": false
}

GET/v1/companies/{company_id}/financials

Annual accounts filed with the NBB, newest first. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
fiscal_year	query	integer \| null	no	One fiscal year; default all, newest first.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [],
  "has_more": false
}

GET/v1/companies/{company_id}/events

The events of one company, newest first. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [],
  "has_more": false
}

GET/v1/companies/{company_id}/graph

The ownership graph from a company, one or two levels, companies only. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
depth	query	integer	no	1 or 2 levels of ownership from the root.

Example

{
  "object": "graph",
  "root": "be:0200068636",
  "depth": 1,
  "truncated": false,
  "nodes": [
    {
      "id": "be:0200068636",
      "object": "company",
      "name": "Farys"
    },
    {
      "id": "be:0367300594",
      "object": "company",
      "name": "Stadsontwikkeling Gent (sogent)"
    }
  ],
  "edges": [
    {
      "id": "rel_o2_be:0367300594",
      "from": "be:0367300594",
      "to": "be:0200068636",
      "type": "shareholder",
      "share_pct": 0.01
    }
  ]
}

GET/v1/companies/{company_id}/publications

Belgisch Staatsblad publications of a company, newest first. Included in the unlock.

name	in	type	required	description
company_id	path	string	yes	be:0200068636, BE0200068636, 0200.068.636 or the bare digits.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [],
  "has_more": false
}

GET/v1/events

The event feed: incorporations, dissolutions, bankruptcies, moves, press and hiring. Returns stubs, included in your key.

name	in	type	required	description
type	query	string \| null	no	Required. company.incorporated, company.dissolved, company.name_changed, company.address_changed, company.bankruptcy_opened, company.status_changed, relationship.changed, company.capital_changed, financials.filed, press.mentioned, hiring.posted, web.domain_found.
province	query	string \| null	no	Dutch or French name, e.g. gent.
municipality	query	string \| null	no	Dutch or French name, e.g. gent.
postal_code	query	string \| null	no	Registry events only.
activity	query	string \| null	no	Incorporations only: comma list of NACE-BEL 2025 prefixes, e.g. 56 or 56.1,56.3.
activity_source	query	string \| null	no	any (default), kbo or deed.
occurred_after	query	string \| null	no	ISO date; the feed has no default window for incorporations and 90 days for press and hiring.
lang	query	string (nl \| fr \| en)	no	Label language for activities and legal forms.
limit	query	integer \| null	no	1 to 100, default 50.
cursor	query	string \| null	no	next_cursor from the previous page, unchanged.

Example

{
  "object": "list",
  "data": [
    {
      "id": "evt_g42",
      "object": "event",
      "type": "company.incorporated",
      "occurred_on": "2026-10-28",
      "detected_at": "2026-10-29T02:10:00+00:00",
      "company": {
        "id": "be:1044404938",
        "name": "CAFE MAAL TWEE",
        "legal_form": "BV",
        "locality": "Ledeberg",
        "municipality": "Gent",
        "province": "Oost-Vlaanderen"
      },
      "data": {
        "activities": [
          {
            "scheme": "nace_bel_2025",
            "code": "56301",
            "source": "kbo",
            "primary": true
          }
        ]
      },
      "source": {
        "name": "be_staatsblad",
        "ref": "2026-123456",
        "url": "/tsv_pdf/2026/10/28/2026123456.pdf",
        "published_on": "2026-10-28"
      }
    }
  ],
  "has_more": false
}