Documentatie

OpenAPI-spec

The whole API is described by an OpenAPI 3 document. Use it to generate clients, import the API into Postman or Insomnia, or browse it in any OpenAPI viewer.

Download the spec#

• v2 (current): /assets/openapi-v2.json
• Live, always current & multilingual: https://companybelgium.be/api/openapi/{lang} (fr · en · nl)

Generate a client#

Point any generator at the spec, e.g. with openapi-generator or openapi-typescript, to get typed bindings in your language.

Import into Postman#

• Postman → Import → Link, then paste the spec URL.
• Add a collection-level X-API-Key and X-API-Secret header.
• Store both as collection variables so they never end up in shared requests.