Search
Fuzzy company search, the same engine that powers the search box on jaarrekening.be. Tolerates typos, ignores word order and matches the last word as a prefix, so partial input while a user is still typing resolves to the right company.
Use this endpoint to turn what a user typed into an enterprise number. Use GET /enterprises instead when you already have an exact name or number and want a filterable, paginated list.
Purely numeric input is matched against the enterprise number rather than the name. Separators are ignored, so BE0867441056, 0867.446.056 and 0867 446 056 are equivalent. Results are ranked by relevance and are not paginated.
GET /enterprises matches exactly instead. Searching colruit group there
returns nothing, because no company name contains that exact text. Here it
returns Colruyt Group, the company the user meant.Which endpoint should I use?
number from this endpoint, pass it to any of the
/enterprises/{search}/… endpoints to pull financials, directors and the rest.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
What the user typed. A company name, part of a name, or an enterprise number. Minimum 2 characters.
2 - 200Number of results to return.
1 <= x <= 50Comma separated ISO country codes to narrow results to, for example BE,FR. This only ever narrows: it cannot grant access to data your token does not already cover.
Response
Matching enterprises, most relevant first. An empty data array means no match.
The response is of type object.
