Documentation / API Playground

API BCE sandbox: try the API in your browser, no sign-up

API BCE sandbox: send real requests from your browser with the demo key, fictitious test data or your own key, and read the response and timing.

Send real requests to the live v2 API. Without an account, use the demo key; with an account, paste your own key.

Demo requests go through api-bce.be with a shared key: 15 requests every 10 minutes, public register data only.

GET /enterprise/{num}
cURL
curl "" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Three ways to use the API BCE sandbox#

The sandbox sends real requests from your browser and shows the response and its timing. Before you start, pick the mode that fits your goal.

  • Demo key: no sign-up needed. It uses a shared key limited to 15 requests every 10 minutes and to public register data.
  • Test data: fictitious companies served by the test API, ideal for error cases.
  • My API key: your own key and secret, which stay in the tab and reach the API only for that request.

Practical uses for the whole team#

The sandbox is not only for developers. For example, a product manager can check which fields a record contains before writing a specification. Similarly, a support agent can reproduce a customer issue with the exact number involved. Developers, in turn, can compare the response time and the remaining quota of a call. However, some endpoints need your own key, and the sandbox tells you when that is the case.

In addition, test data is the fastest way to see error responses. Try 0999.999.229 for a bankruptcy, or 0999.999.526 for an exceeded quota. Then, compare those answers with what your interface displays.

Moreover, the sandbox is a good place to agree on field names before a sprint starts. Everyone sees the same response, so discussions stay concrete.

Good habits in the sandbox#

Your key and secret are kept in sessionStorage and are never stored on the API BCE side. Even so, avoid pasting a live secret on a shared computer. Also, remember that requests sent with your own live key count against your quota. Finally, once a request works, move it into code and follow the examples.

The sandbox also helps when you open a support ticket. For instance, reproduce the call there, copy the request and the response, and attach both. As a result, the issue can be understood without access to your systems. However, remove any personal data before you share a response. Also, the remaining quota appears after each call made with your key, which is a quick way to check usage.

API BCE sandbox FAQ#

Do I need an account to try the sandbox?

No. The demo key works without sign-up, within 15 requests every 10 minutes.

Is my secret stored when I use my own key?

No. It stays in the browser tab and is only forwarded to the API for the request you send.

Why is an endpoint unavailable with the demo key?

The demo key covers public register data only. So, paste your own key, or create a free one, to call that endpoint.