{ "matched": 68, "returned": 2, "hasMore": true, "nextOffset": 2, "sortedBy": "name", "bySituation": [ { "category": "normal", "companies": 66 }, { "category": "insolvency", "companies": 2 } ], "resolvedArea": { "zips": [ "2870", "2890" ], "items": [ { "input": "Puurs-Sint-Amands", "level": "municipality", "area": { "code": "12041", "nl": "Puurs-Sint-Amands", "fr": "Puurs-Sint-Amands" }, "zips": [ "2870", "2890" ], "includes": [ "Breendonk", "Liezele", "Lippelo", "Oppuurs", "Puurs", "Ruisbroek", "Sint-Amands" ] } ] }, "nace": [ { "input": "56.1", "code": "56.1", "versions": [ "NACE-BEL 2025", "NACE-BEL 2008" ], "nl": "Restaurants en mobiele eetgelegenheden", "fr": "Restaurants et services de restauration mobile", "en": "Restaurants and mobile food service activities" } ], "unsupported": [ { "aspect": "has a terrace", "reason": "the screen cannot filter on this. Check it per company with get_company, or say that it was not applied" } ], "results": [ { "enterpriseNumber": "BE0789990368", "name": "Den Amandus", "zipCode": "2890", "municipality": "Puurs-Sint-Amands", "founded": "2022-03-01", "mainActivity": { "code": "56.111", "version": "NACE-BEL 2025", "nl": "Activiteiten van eetgelegenheden met volledige bediening" }, "situation": { "code": "000", "nl": "Normale toestand", "fr": "Situation normale", "en": "Normal situation", "category": "normal" } }, { "enterpriseNumber": "BE0863104614", "name": "PUURS LOF", "zipCode": "2870", "municipality": "Puurs-Sint-Amands", "founded": "2004-01-30", "mainActivity": { "code": "56.111", "version": "NACE-BEL 2025", "nl": "Activiteiten van eetgelegenheden met volledige bediening" } } ]}
{
"code": "filter_required"
}
{
"code": "missing_token"
}
{
"code": "insufficient_credits"
}
{
"code": "rate_limited"
}
{
"code": "internal"
}
{
"code": "busy"
}
Companies
Screen companies
Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.
name (the default), oldest, newest, or a figure from GET /v1/figures, such as employees, analysis.solvency or growth3y.turnover. Companies with no value for the figure come last.
Keep the companies whose newest filing has the figure at least this value, such as min[equity]=1000000. A company with no value does not pass. A ratio is a fraction: min[analysis.solvency]=0.5 is 50%.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OTB Studio","description":"Developer docs for OTB Studio: the Belgian company register (KBO/BCE) with directors, shareholders and filed annual accounts, through a REST API and an MCP server for Claude, ChatGPT, Cursor and other agents.","colors":{"primary":"#304ff0","light":"#93b4ff","dark":"#304ff0"},"logo":{"light":"https://mintcdn.com/otb-studio/wPQNYQt8AAFhoH-l/logo/light.svg?fit=max\u0026auto=format\u0026n=wPQNYQt8AAFhoH-l\u0026q=85\u0026s=cfa30d3ffe22ef19459b3bf491f7e4d8","dark":"https://mintcdn.com/otb-studio/wPQNYQt8AAFhoH-l/logo/dark.svg?fit=max\u0026auto=format\u0026n=wPQNYQt8AAFhoH-l\u0026q=85\u0026s=5650d5eacad5031ee48f10ce98941602","href":"https://otbstudio.ai"},"favicon":"https://mintcdn.com/otb-studio/wPQNYQt8AAFhoH-l/favicon.svg?fit=max\u0026auto=format\u0026n=wPQNYQt8AAFhoH-l\u0026q=85\u0026s=6753de2261fe0721ef2b746b529bae74","api":{"playground":{"display":"interactive"}},"background":{"color":{"light":"#f3f6fd","dark":"#16112f"}},"navbar":{"links":[{"href":"https://app.otbstudio.ai/auth/sign-in","label":"Log in"}],"primary":{"type":"button","label":"Sign up","href":"https://app.otbstudio.ai/auth/sign-up"}},"footer":{"links":[{"header":"OTB Studio","items":[{"label":"Website","href":"https://otbstudio.ai"},{"label":"Pricing","href":"https://otbstudio.ai/"},{"label":"Dashboard","href":"https://app.otbstudio.ai"}]},{"header":"Support","items":[{"label":"engineering@otbstudio.ai","href":"mailto:engineering@otbstudio.ai"}]},{"header":"Legal","items":[{"label":"Terms","href":"https://otbstudio.ai/terms"},{"label":"Privacy","href":"https://otbstudio.ai/privacy"},{"label":"Cookies","href":"https://otbstudio.ai/cookies"}]}]},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"nl","href":"nl"},{"language":"fr","href":"fr"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"otb-studio","hasAudioNarration":false,"actualSubdomain":"otb-studio","customDomains":["docs.otbstudio.ai"],"gitSource":{"type":"github","owner":"otb-studio","repo":"docs","deployBranch":"develop","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6adb578ebc8f385cbd3425b3"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae49709e7bd3811c809098a","collectionId":"c42dfaa8-465a-4346-94e4-86cd1c3e1724","liveDeploymentHistoryId":"6ae49709e7bd3811c809098a","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4972dfb630df5bd5110b8","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"en","tag":"Guides","count":11},{"language":"fr","tag":"Guides","count":11},{"language":"nl","tag":"Gidsen","count":11},{"language":"en","tag":"API reference","count":6},{"language":"en","tag":"Companies","count":6},{"language":"fr","tag":"Référence API","count":6},{"language":"fr","tag":"Companies","count":6},{"language":"nl","tag":"API-referentie","count":6},{"language":"nl","tag":"Companies","count":6},{"language":"en","tag":"Get started","count":3},{"language":"en","tag":"Data","count":3},{"language":"en","tag":"Connect","count":3},{"language":"fr","tag":"Démarrer","count":3},{"language":"fr","tag":"Données","count":3},{"language":"fr","tag":"Connecter","count":3},{"language":"nl","tag":"Aan de slag","count":3},{"language":"nl","tag":"Data","count":3},{"language":"nl","tag":"Verbinden","count":3},{"language":"en","tag":"Production","count":2},{"language":"fr","tag":"En production","count":2},{"language":"nl","tag":"In productie","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/en/companies/screen-companies","slug":"/api-reference/en/companies/screen-companies","pageMetadata":{"title":"Screen companies","description":"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of `nace`, `area`, `legal_form` or `situation`. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/screen","href":"/api-reference/en/companies/screen-companies","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of \", _jsx(_components.code, {\n children: \"nace\"\n }), \", \", _jsx(_components.code, {\n children: \"area\"\n }), \", \", _jsx(_components.code, {\n children: \"legal_form\"\n }), \" or \", _jsx(_components.code, {\n children: \"situation\"\n }), \". The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Screen companies","description":"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of `nace`, `area`, `legal_form` or `situation`. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/screen","href":"/api-reference/en/companies/screen-companies","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Companies"],"operationId":"screenCompanies","summary":"Screen companies","description":"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of `nace`, `area`, `legal_form` or `situation`. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.","parameters":["1287385a-fc7f-4158-bb97-e077ebd2ecb9","017df9ba-f3b2-4380-ba7f-9ed35bcb9daf","1e45ed78-d35d-4487-bdd9-b22e7fe52409","2c2afe3e-8b9e-4b75-9aaf-40e37ed4ae6f","a559afb2-64b7-42a5-a9c7-958716eeb82e","622a49e4-04c6-4676-86cd-87003ea3a1a0","1e879904-9f4d-427f-92b2-57912560fa08","fc9c21a3-4bdc-4d8e-afc0-19d9edad3e2d","d4fbeb3f-6fa3-46e0-a616-2cbca823468f","bf57abd4-6d29-4576-a143-52cc3172ef88","fb4d9aa5-1a6a-4c06-abdf-531acd559ca3","e244fb56-7c3e-4f06-95b2-98168938fa8f","a78979d6-35f6-4acd-b10f-4914480915d6","0f204ab5-f1cd-4d33-bd9e-0819b3c770de","fa6213a6-5281-41f6-a51f-60ffd95b9237","bad41d9b-fc37-4dbc-a3c0-dfd813d9f2c1"],"responses":{"200":"d2ff23e0-eafd-47f6-87bd-e1885d9111ad","400":"62c088af-b699-4eac-a5e4-26744c1acd95","401":"009f8664-2980-453d-b15a-3e7880d66bd2","402":"8d289058-1b0f-4a2f-be54-5de1e8cb3c82","429":"61dce4d0-31cd-4eac-b870-8e4549577c62","500":"165f8bcc-4c9f-4136-b091-7d9a9b4efd15","503":"aae47f50-658b-499b-9be0-a99be35319d6"},"method":"get","type":"path","servers":["e4418f25-d78f-454c-8ef5-ca08164f4298"],"security":["f5df1979-ce81-41c5-afc9-bc1dadb59f50"],"path":"/v1/companies/screen","baseUrlOptions":["https://api.otbstudio.ai"],"title":"Screen companies","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1287385a-fc7f-4158-bb97-e077ebd2ecb9":{"name":"nace","in":"query","required":false,"description":"A NACE-BEL code or prefix, such as `56.1`. Repeat for more. A prefix of 4 digits or less matches the 2008 and the 2025 version.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A NACE-BEL code or prefix, such as `56.1`. Repeat for more. A prefix of 4 digits or less matches the 2008 and the 2025 version.","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true,"example":["56.1"]},"017df9ba-f3b2-4380-ba7f-9ed35bcb9daf":{"name":"activity","in":"query","required":false,"description":"`main` (the default) or `any`, which adds the secondary and ancillary activities.","schema":{"type":"string","enum":["main","any"],"isRequired":false,"description":"`main` (the default) or `any`, which adds the secondary and ancillary activities.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"1e45ed78-d35d-4487-bdd9-b22e7fe52409":{"name":"area","in":"query","required":false,"description":"A municipality, sub-municipality, arrondissement, province, region, zip code or area code. Repeat for more.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A municipality, sub-municipality, arrondissement, province, region, zip code or area code. Repeat for more.","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true,"example":["Puurs-Sint-Amands"]},"2c2afe3e-8b9e-4b75-9aaf-40e37ed4ae6f":{"name":"legal_form","in":"query","required":false,"description":"A KBO legal form code, such as `014`. Repeat for more.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A KBO legal form code, such as `014`. Repeat for more.","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true},"a559afb2-64b7-42a5-a9c7-958716eeb82e":{"name":"situation","in":"query","required":false,"description":"A juridical situation category: `normal`, `insolvency`, `dissolution`, `merger_or_split` or `ended`. Repeat for more.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A juridical situation category: `normal`, `insolvency`, `dissolution`, `merger_or_split` or `ended`. Repeat for more.","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true},"622a49e4-04c6-4676-86cd-87003ea3a1a0":{"name":"founded_after","in":"query","required":false,"description":"Founded on or after this date.","schema":{"type":"string","format":"date","isRequired":false,"description":"Founded on or after this date.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"1e879904-9f4d-427f-92b2-57912560fa08":{"name":"founded_before","in":"query","required":false,"description":"Founded on or before this date.","schema":{"type":"string","format":"date","isRequired":false,"description":"Founded on or before this date.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"fc9c21a3-4bdc-4d8e-afc0-19d9edad3e2d":{"name":"include_inactive","in":"query","required":false,"description":"`true` also lists companies that are struck off.","schema":{"type":"boolean","default":false,"isRequired":false,"description":"`true` also lists companies that are struck off.","uniqueKey":"","typeLabel":"boolean"}},"d4fbeb3f-6fa3-46e0-a616-2cbca823468f":{"name":"sort_by","in":"query","required":false,"description":"`name` (the default), `oldest`, `newest`, or a figure from `GET /v1/figures`, such as `employees`, `analysis.solvency` or `growth3y.turnover`. Companies with no value for the figure come last.","schema":{"type":"string","default":"name","isRequired":false,"description":"`name` (the default), `oldest`, `newest`, or a figure from `GET /v1/figures`, such as `employees`, `analysis.solvency` or `growth3y.turnover`. Companies with no value for the figure come last.","uniqueKey":"","typeLabel":"string"}},"bf57abd4-6d29-4576-a143-52cc3172ef88":{"name":"sort_order","in":"query","required":false,"description":"For a figure: `desc` (the default) or `asc`.","schema":{"type":"string","enum":["desc","asc"],"default":"desc","isRequired":false,"description":"For a figure: `desc` (the default) or `asc`.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"fb4d9aa5-1a6a-4c06-abdf-531acd559ca3":{"name":"min","in":"query","required":false,"description":"Keep the companies whose newest filing has the figure at least this value, such as `min[equity]=1000000`. A company with no value does not pass. A ratio is a fraction: `min[analysis.solvency]=0.5` is 50%.","style":"deepObject","explode":true,"schema":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"additionalProperties","typeLabel":"number"},"isRequired":false,"description":"Keep the companies whose newest filing has the figure at least this value, such as `min[equity]=1000000`. A company with no value does not pass. A ratio is a fraction: `min[analysis.solvency]=0.5` is 50%.","uniqueKey":"","typeLabel":"object"}},"e244fb56-7c3e-4f06-95b2-98168938fa8f":{"name":"max","in":"query","required":false,"description":"Keep the companies whose newest filing has the figure at most this value, such as `max[analysis.customerCreditDays]=30`.","style":"deepObject","explode":true,"schema":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"additionalProperties","typeLabel":"number"},"isRequired":false,"description":"Keep the companies whose newest filing has the figure at most this value, such as `max[analysis.customerCreditDays]=30`.","uniqueKey":"","typeLabel":"object"}},"a78979d6-35f6-4acd-b10f-4914480915d6":{"name":"include","in":"query","required":false,"description":"A figure each result also shows, such as `turnover`. Repeat for more. Each value costs a credit, and a result of a screen that uses a figure 2 more.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A figure each result also shows, such as `turnover`. Repeat for more. Each value costs a credit, and a result of a screen that uses a figure 2 more.","uniqueKey":"","typeLabel":"string[]"}},"0f204ab5-f1cd-4d33-bd9e-0819b3c770de":{"name":"limit","in":"query","required":false,"description":"How many companies to return, 1 to 50. A missing, zero or negative value gives 20, a larger one 50.","schema":{"type":"integer","default":20,"isRequired":false,"description":"How many companies to return, 1 to 50. A missing, zero or negative value gives 20, a larger one 50.","uniqueKey":"","typeLabel":"integer"}},"fa6213a6-5281-41f6-a51f-60ffd95b9237":{"name":"offset","in":"query","required":false,"description":"Where the page starts. Take it from `nextOffset`.","schema":{"type":"integer","default":0,"isRequired":false,"description":"Where the page starts. Take it from `nextOffset`.","uniqueKey":"","typeLabel":"integer"}},"bad41d9b-fc37-4dbc-a3c0-dfd813d9f2c1":{"name":"also_requested","in":"query","required":false,"description":"A part of the request no filter covers, such as `has a terrace`. It comes back in `unsupported`. Repeat for more.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"A part of the request no filter covers, such as `has a terrace`. It comes back in `unsupported`. Repeat for more.","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true}},"responses":{"d2ff23e0-eafd-47f6-87bd-e1885d9111ad":{"description":"The companies that matched, and what the screen did with the request.","headers":{"X-Credits-Cost":{"description":"What this reply cost, in credits.","schema":{"type":"integer"}},"X-Credits-Remaining":{"description":"The balance after this reply.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","description":"The companies that matched, and what the screen did with the request.","additionalProperties":false,"required":["matched","returned","hasMore","sortedBy","bySituation","unsupported","results"],"properties":{"matched":{"type":"integer","description":"Every company that passed the filters, not only this page.","isRequired":true,"uniqueKey":"matched","typeLabel":"integer"},"returned":{"type":"integer","isRequired":true,"uniqueKey":"returned","typeLabel":"integer"},"hasMore":{"type":"boolean","isRequired":true,"uniqueKey":"hasMore","typeLabel":"boolean"},"sortedBy":{"type":"string","description":"`name`, `oldest`, `newest`, or a figure and its order, such as `employees desc`.","isRequired":true,"uniqueKey":"sortedBy","typeLabel":"string"},"bySituation":{"type":"array","items":{"type":"object","description":"How many matched companies are in one situation category.","additionalProperties":false,"required":["category","companies"],"properties":{"category":{"type":"string","isRequired":true,"uniqueKey":"bySituation.items.[INDEX].category","typeLabel":"string"},"companies":{"type":"integer","isRequired":true,"uniqueKey":"bySituation.items.[INDEX].companies","typeLabel":"integer"}},"uniqueKey":"bySituation.items.[INDEX]","typeLabel":"object"},"description":"The matched companies per juridical situation category, so a list that includes bankruptcies says so.","isRequired":true,"uniqueKey":"bySituation","typeLabel":"object[]"},"unsupported":{"type":"array","items":{"type":"object","description":"One part of the request the screen did not apply.","additionalProperties":false,"required":["aspect","reason"],"properties":{"aspect":{"type":"string","isRequired":true,"uniqueKey":"unsupported.items.[INDEX].aspect","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"unsupported.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"unsupported.items.[INDEX]","typeLabel":"object"},"description":"Every part of the request the screen did not apply, with the reason.","isRequired":true,"uniqueKey":"unsupported","typeLabel":"object[]"},"results":{"type":"array","items":{"type":"object","description":"One company. Thin on purpose: open it with `GET /v1/companies/{id}` for the rest.","additionalProperties":false,"required":["enterpriseNumber","name"],"properties":{"enterpriseNumber":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].enterpriseNumber","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].name","typeLabel":"string"},"zipCode":{"type":"string","uniqueKey":"results.items.[INDEX].zipCode","typeLabel":"string"},"municipality":{"type":"string","description":"Statbel's name of the municipality, in Dutch.","uniqueKey":"results.items.[INDEX].municipality","typeLabel":"string"},"founded":{"type":"string","format":"date","uniqueKey":"results.items.[INDEX].founded","typeLabel":"string\u003cdate>"},"mainActivity":{"type":"object","description":"The main code that matched the `nace` filter, or the newest main code.","required":["code","version"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].mainActivity.code","typeLabel":"string"},"version":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].mainActivity.version","typeLabel":"string"},"nl":{"type":"string","uniqueKey":"results.items.[INDEX].mainActivity.nl","typeLabel":"string"},"fr":{"type":"string","uniqueKey":"results.items.[INDEX].mainActivity.fr","typeLabel":"string"},"en":{"type":"string","uniqueKey":"results.items.[INDEX].mainActivity.en","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"results.items.[INDEX].mainActivity","typeLabel":"object"},"juridicalForm":{"type":"object","description":"A KBO reference code with the register's own description. KBO's code list has Dutch and French; `en` is OpenTheBox's English.","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","description":"The KBO code, the same as in the matching `...Code` field.","isRequired":true,"uniqueKey":"results.items.[INDEX].juridicalForm.code","typeLabel":"string"},"nl":{"type":"string","description":"KBO's description in Dutch. Absent when KBO's code list has no row for the code.","uniqueKey":"results.items.[INDEX].juridicalForm.nl","typeLabel":"string"},"fr":{"type":"string","description":"KBO's description in French.","uniqueKey":"results.items.[INDEX].juridicalForm.fr","typeLabel":"string"},"en":{"type":"string","description":"An English description, from OpenTheBox, not KBO: KBO publishes no English. Quote `nl` or `fr` when the official wording matters.","uniqueKey":"results.items.[INDEX].juridicalForm.en","typeLabel":"string"},"text":{"type":"string","description":"The provider's own words for the legal form of a company registered abroad, such as `SARL`. It is not a KBO code and has no translation; then `nl`, `fr` and `en` are absent.","uniqueKey":"results.items.[INDEX].juridicalForm.text","typeLabel":"string"},"category":{"type":"string","description":"Only on `juridicalSituation`: `normal`, `dissolution`, `insolvency` (a procedure running now), `merger_or_split` or `ended`. The grouping is OpenTheBox's, not KBO's.","uniqueKey":"results.items.[INDEX].juridicalForm.category","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].juridicalForm","typeLabel":"object"},"situation":{"type":"object","description":"A KBO reference code with the register's own description. KBO's code list has Dutch and French; `en` is OpenTheBox's English.","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","description":"The KBO code, the same as in the matching `...Code` field.","isRequired":true,"uniqueKey":"results.items.[INDEX].situation.code","typeLabel":"string"},"nl":{"type":"string","description":"KBO's description in Dutch. Absent when KBO's code list has no row for the code.","uniqueKey":"results.items.[INDEX].situation.nl","typeLabel":"string"},"fr":{"type":"string","description":"KBO's description in French.","uniqueKey":"results.items.[INDEX].situation.fr","typeLabel":"string"},"en":{"type":"string","description":"An English description, from OpenTheBox, not KBO: KBO publishes no English. Quote `nl` or `fr` when the official wording matters.","uniqueKey":"results.items.[INDEX].situation.en","typeLabel":"string"},"text":{"type":"string","description":"The provider's own words for the legal form of a company registered abroad, such as `SARL`. It is not a KBO code and has no translation; then `nl`, `fr` and `en` are absent.","uniqueKey":"results.items.[INDEX].situation.text","typeLabel":"string"},"category":{"type":"string","description":"Only on `juridicalSituation`: `normal`, `dissolution`, `insolvency` (a procedure running now), `merger_or_split` or `ended`. The grouping is OpenTheBox's, not KBO's.","uniqueKey":"results.items.[INDEX].situation.category","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].situation","typeLabel":"object"},"figures":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"results.items.[INDEX].figures.additionalProperties","typeLabel":"number"},"description":"The newest values of the figures the screen filtered or sorted on, and of those in `include`, by the name in `GET /v1/figures`. A growth is a fraction: 0.2 is 20%. A figure with no value is left out. Each value costs a credit, and a result of a screen that uses a figure 2 more.","uniqueKey":"results.items.[INDEX].figures","typeLabel":"object"},"figuresClosingDate":{"type":"string","format":"date","description":"The closing date of the filing the figures are from.","uniqueKey":"results.items.[INDEX].figuresClosingDate","typeLabel":"string\u003cdate>"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"nextOffset":{"type":"integer","description":"The offset of the next page, when there is one.","uniqueKey":"nextOffset","typeLabel":"integer"},"bounds":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"min":{"type":"number","uniqueKey":"bounds.additionalProperties.min","typeLabel":"number"},"max":{"type":"number","uniqueKey":"bounds.additionalProperties.max","typeLabel":"number"}},"uniqueKey":"bounds.additionalProperties","typeLabel":"object"},"description":"The min and max the screen applied, by figure, such as `{\"employees\": {\"min\": 10}}`. Each one costs 5 credits: `matched` answers it.","uniqueKey":"bounds","typeLabel":"object"},"resolvedArea":{"type":"object","description":"Every area item resolved, and the zip codes of all of them.","additionalProperties":false,"required":["zips","items"],"properties":{"zips":{"type":"array","items":{"type":"string","uniqueKey":"resolvedArea.zips.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"resolvedArea.zips","typeLabel":"string[]"},"items":{"type":"array","items":{"type":"object","description":"What one area item resolved to.","additionalProperties":false,"required":["input","zips"],"properties":{"input":{"type":"string","isRequired":true,"uniqueKey":"resolvedArea.\\items.items.[INDEX].input","typeLabel":"string"},"zips":{"type":"array","items":{"type":"string","uniqueKey":"resolvedArea.\\items.items.[INDEX].zips.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"resolvedArea.\\items.items.[INDEX].zips","typeLabel":"string[]"},"level":{"type":"string","description":"`municipality`, `sub_municipality`, `arrondissement`, `province`, `region` or `zip`. Absent when the item resolved to no area.","uniqueKey":"resolvedArea.\\items.items.[INDEX].level","typeLabel":"string"},"area":{"type":"object","description":"A Belgian administrative area, from Statbel. Statbel publishes no English.","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","description":"Statbel's NIS code for the area.","isRequired":true,"uniqueKey":"resolvedArea.\\items.items.[INDEX].area.code","typeLabel":"string"},"nl":{"type":"string","description":"Statbel's name in Dutch, without \"Provincie\" or \"Arrondissement\".","uniqueKey":"resolvedArea.\\items.items.[INDEX].area.nl","typeLabel":"string"},"fr":{"type":"string","description":"Statbel's name in French.","uniqueKey":"resolvedArea.\\items.items.[INDEX].area.fr","typeLabel":"string"}},"uniqueKey":"resolvedArea.\\items.items.[INDEX].area","typeLabel":"object"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"resolvedArea.\\items.items.[INDEX].includes.items.[INDEX]","typeLabel":"string"},"description":"The bpost place names in `zips`.","uniqueKey":"resolvedArea.\\items.items.[INDEX].includes","typeLabel":"string[]"},"alternatives":{"type":"array","items":{"type":"object","description":"One candidate area. A sub-municipality also carries its zip codes.","additionalProperties":false,"required":["level","code"],"properties":{"level":{"type":"string","isRequired":true,"uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].level","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].code","typeLabel":"string"},"nl":{"type":"string","uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].nl","typeLabel":"string"},"fr":{"type":"string","uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].fr","typeLabel":"string"},"zips":{"type":"array","items":{"type":"string","uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].zips.items.[INDEX]","typeLabel":"string"},"description":"Only on a sub-municipality: its zip codes, which select it. Its code is its municipality's.","uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX].zips","typeLabel":"string[]"}},"uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives.items.[INDEX]","typeLabel":"object"},"description":"The other areas with the same name. Send one's `code`, or a place's `zips`, to select it.","uniqueKey":"resolvedArea.\\items.items.[INDEX].alternatives","typeLabel":"object[]"},"reason":{"type":"string","description":"Why `zips` is empty, and what to send instead.","uniqueKey":"resolvedArea.\\items.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"resolvedArea.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"resolvedArea.\\items","typeLabel":"object[]"}},"uniqueKey":"resolvedArea","typeLabel":"object"},"nace":{"type":"array","items":{"type":"object","description":"What one NACE input matched.","additionalProperties":false,"required":["input","code","versions"],"properties":{"input":{"type":"string","isRequired":true,"uniqueKey":"nace.items.[INDEX].input","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"nace.items.[INDEX].code","typeLabel":"string"},"versions":{"type":"array","items":{"type":"string","uniqueKey":"nace.items.[INDEX].versions.items.[INDEX]","typeLabel":"string"},"description":"The NACE-BEL versions that have codes under it.","isRequired":true,"uniqueKey":"nace.items.[INDEX].versions","typeLabel":"string[]"},"nl":{"type":"string","description":"KBO's description of the code itself, in Dutch. Absent for a prefix that is no KBO code.","uniqueKey":"nace.items.[INDEX].nl","typeLabel":"string"},"fr":{"type":"string","uniqueKey":"nace.items.[INDEX].fr","typeLabel":"string"},"en":{"type":"string","uniqueKey":"nace.items.[INDEX].en","typeLabel":"string"},"note":{"type":"string","uniqueKey":"nace.items.[INDEX].note","typeLabel":"string"}},"uniqueKey":"nace.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nace","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"matched":68,"returned":2,"hasMore":true,"nextOffset":2,"sortedBy":"name","bySituation":[{"category":"normal","companies":66},{"category":"insolvency","companies":2}],"resolvedArea":{"zips":["2870","2890"],"items":[{"input":"Puurs-Sint-Amands","level":"municipality","area":{"code":"12041","nl":"Puurs-Sint-Amands","fr":"Puurs-Sint-Amands"},"zips":["2870","2890"],"includes":["Breendonk","Liezele","Lippelo","Oppuurs","Puurs","Ruisbroek","Sint-Amands"]}]},"nace":[{"input":"56.1","code":"56.1","versions":["NACE-BEL 2025","NACE-BEL 2008"],"nl":"Restaurants en mobiele eetgelegenheden","fr":"Restaurants et services de restauration mobile","en":"Restaurants and mobile food service activities"}],"unsupported":[{"aspect":"has a terrace","reason":"the screen cannot filter on this. Check it per company with get_company, or say that it was not applied"}],"results":[{"enterpriseNumber":"BE0789990368","name":"Den Amandus","zipCode":"2890","municipality":"Puurs-Sint-Amands","founded":"2022-03-01","mainActivity":{"code":"56.111","version":"NACE-BEL 2025","nl":"Activiteiten van eetgelegenheden met volledige bediening"},"situation":{"code":"000","nl":"Normale toestand","fr":"Situation normale","en":"Normal situation","category":"normal"}},{"enterpriseNumber":"BE0863104614","name":"PUURS LOF","zipCode":"2870","municipality":"Puurs-Sint-Amands","founded":"2004-01-30","mainActivity":{"code":"56.111","version":"NACE-BEL 2025","nl":"Activiteiten van eetgelegenheden met volledige bediening"}}]},"examples":{"Example":{"title":"Example","value":{"matched":68,"returned":2,"hasMore":true,"nextOffset":2,"sortedBy":"name","bySituation":[{"category":"normal","companies":66},{"category":"insolvency","companies":2}],"resolvedArea":{"zips":["2870","2890"],"items":[{"input":"Puurs-Sint-Amands","level":"municipality","area":{"code":"12041","nl":"Puurs-Sint-Amands","fr":"Puurs-Sint-Amands"},"zips":["2870","2890"],"includes":["Breendonk","Liezele","Lippelo","Oppuurs","Puurs","Ruisbroek","Sint-Amands"]}]},"nace":[{"input":"56.1","code":"56.1","versions":["NACE-BEL 2025","NACE-BEL 2008"],"nl":"Restaurants en mobiele eetgelegenheden","fr":"Restaurants et services de restauration mobile","en":"Restaurants and mobile food service activities"}],"unsupported":[{"aspect":"has a terrace","reason":"the screen cannot filter on this. Check it per company with get_company, or say that it was not applied"}],"results":[{"enterpriseNumber":"BE0789990368","name":"Den Amandus","zipCode":"2890","municipality":"Puurs-Sint-Amands","founded":"2022-03-01","mainActivity":{"code":"56.111","version":"NACE-BEL 2025","nl":"Activiteiten van eetgelegenheden met volledige bediening"},"situation":{"code":"000","nl":"Normale toestand","fr":"Situation normale","en":"Normal situation","category":"normal"}},{"enterpriseNumber":"BE0863104614","name":"PUURS LOF","zipCode":"2870","municipality":"Puurs-Sint-Amands","founded":"2004-01-30","mainActivity":{"code":"56.111","version":"NACE-BEL 2025","nl":"Activiteiten van eetgelegenheden met volledige bediening"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"62c088af-b699-4eac-a5e4-26744c1acd95":{"description":"No `nace`, `area`, `legal_form` or `situation` filter.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["filter_required"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"filter_required"}}},"exampleType":"generated"}},"exampleType":"generated"},"009f8664-2980-453d-b15a-3e7880d66bd2":{"description":"No token, or a token that is not valid. `missing_token` when there is no `Authorization: Bearer` header, `invalid_token` when the token is unknown, revoked or of the wrong kind.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["missing_token","invalid_token"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"missing_token"}}},"exampleType":"generated"}},"exampleType":"generated"},"8d289058-1b0f-4a2f-be54-5de1e8cb3c82":{"description":"The organisation has no plan, its balance is empty, or the balance does not cover this reply. When the reply was too expensive, the headers say what it would have cost and what is left.","headers":{"X-Credits-Cost":{"description":"What this reply cost, in credits.","schema":{"type":"integer"}},"X-Credits-Remaining":{"description":"The balance after this reply.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["insufficient_credits"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_credits"}}},"exampleType":"generated"}},"exampleType":"generated"},"61dce4d0-31cd-4eac-b870-8e4549577c62":{"description":"The organisation is over its rate (10 calls a second, bursts of 20). Retry after `Retry-After`.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["rate_limited"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"rate_limited"}}},"exampleType":"generated"}},"exampleType":"generated"},"165f8bcc-4c9f-4136-b091-7d9a9b4efd15":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["internal"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"internal"}}},"exampleType":"generated"}},"exampleType":"generated"},"aae47f50-658b-499b-9be0-a99be35319d6":{"description":"The data could not be read within 15 seconds. Retry after `Retry-After`.","headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","enum":["busy"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"busy"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f5df1979-ce81-41c5-afc9-bc1dadb59f50":{"token":{"type":"http","scheme":"bearer","description":"An `otb_live_` token, minted in the OTB Studio dashboard.","scopes":[],"schemeName":"token"}}},"servers":{"e4418f25-d78f-454c-8ef5-ca08164f4298":{"url":"https://api.otbstudio.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An `otb_live_` token, minted in the OTB Studio dashboard.","scopes":[],"schemeName":"token"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An `otb_live_` token, minted in the OTB Studio dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"token","name":"Authorization"}],"title":"token"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"otb-studio","siteName":"OTB Studio","title":"Screen companies - OTB Studio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/en/companies/screen-companies","matchLevel":0},"nl":{"href":"/nl","matchLevel":4},"fr":{"href":"/fr","matchLevel":4}}},"lastModified":"2026-10-30T13:10:10.092Z","originalFileLocation":"api-reference/en/companies/screen-companies.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OTB Studio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Screen companies - OTB Studio\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OTB Studio\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://otb-studio.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Screen+companies\u0026amp;description=Lists+companies+by+what+they+do+and+where+they+are.+Every+filter+is+optional+and+the+filters+combine+with+AND%3B+give+at+least+one+of+%60nace%60%2C+%60area%60%2C+%60legal_form%60\u0026amp;theme=30e1482d7e90aa7be7d626c6\u0026amp;signature=85582f32b138d14143584cc133b3e4dc53dbeff198d9956b78ab7e0c21e36acc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Screen companies - OTB Studio\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://otb-studio.mintlify.app/_mintlify/api/og/v2?division=Companies\u0026amp;title=Screen+companies\u0026amp;description=Lists+companies+by+what+they+do+and+where+they+are.+Every+filter+is+optional+and+the+filters+combine+with+AND%3B+give+at+least+one+of+%60nace%60%2C+%60area%60%2C+%60legal_form%60\u0026amp;theme=30e1482d7e90aa7be7d626c6\u0026amp;signature=85582f32b138d14143584cc133b3e4dc53dbeff198d9956b78ab7e0c21e36acc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/otb-studio/jd48kfATFFQm9_-v/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OTB Studio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#304ff0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/en/companies/screen-companies.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.otbstudio.ai/#organization\",\"name\":\"OTB Studio\",\"url\":\"https://docs.otbstudio.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/otb-studio/wPQNYQt8AAFhoH-l/logo/light.svg?fit=max\u0026auto=format\u0026n=wPQNYQt8AAFhoH-l\u0026q=85\u0026s=cfa30d3ffe22ef19459b3bf491f7e4d8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.otbstudio.ai#website\",\"name\":\"OTB Studio\",\"url\":\"https://docs.otbstudio.ai\",\"publisher\":{\"@id\":\"https://docs.otbstudio.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies#webpage\",\"url\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies\",\"name\":\"Screen companies\",\"description\":\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\",\"dateModified\":\"2026-10-30T13:10:10.092Z\",\"isPartOf\":{\"@id\":\"https://docs.otbstudio.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Companies\",\"item\":\"https://docs.otbstudio.ai/api-reference/en/companies/search-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Screen companies\",\"item\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies#apireference\",\"headline\":\"Screen companies\",\"name\":\"Screen companies\",\"description\":\"Lists companies by what they do and where they are. Every filter is optional and the filters combine with AND; give at least one of nace, area, legal_form or situation. The default list is active companies, which includes companies in bankruptcy or dissolution. The results cost nothing.\",\"url\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.otbstudio.ai/api-reference/en/companies/screen-companies#webpage\"},\"dateModified\":\"2026-10-30T13:10:10.092Z\",\"publisher\":{\"@id\":\"https://docs.otbstudio.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.otbstudio.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OTB Studio\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OTB Studio","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Companies","pages":[{"title":"Search companies","description":"Finds companies by name. A match is deliberately thin: pick the one you mean and fetch its profile by enterprise number. Legal, commercial, Dutch and French names are all searched.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies","href":"/api-reference/en/companies/search-companies"},{"title":"Screen companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/screen","href":"/api-reference/en/companies/screen-companies"},{"title":"Get a company","description":"One company's profile: names, status, legal form, address, contact details, activities, the newest filed figures, and flags saying which other datasets exist for it.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{id}","href":"/api-reference/en/companies/get-a-company"},{"title":"Get ownership","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{id}/ownership","href":"/api-reference/en/companies/get-ownership"},{"title":"Get filed financials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{id}/financials","href":"/api-reference/en/companies/get-filed-financials"},{"title":"Get people","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/companies/{id}/people","href":"/api-reference/en/companies/get-people"}]}]}]},{"language":"nl","pages":[{"title":"nl","href":"/nl"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr"}]}]},"title":"Screen companies - OTB Studio","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}