Documentatie

Subsido bundelt de Belgische (federale, Vlaamse, Waalse en Brusselse) en Europese maatregelen voor burgers en ondernemingen in één genormaliseerd datamodel: subsidies, premies, leningen, waarborgen en fiscale maatregelen. De API zegt welke ervan passen bij een onderneming en een project, waarom, en wat er nog ontbreekt, en meldt het wanneer er iets verandert.

Basis-URL https://api.subsido.be/v1. JSON over HTTPS, tijdstempels in RFC 3339 met de Brusselse tijdzone, één foutstructuur op elke route, en een OpenAPI 3.1-document op /v1/openapi.json dat geen sleutel vraagt.

$ curl "https://api.subsido.be/v1/subsidies?region=flanders&status=open,continuous&limit=5&lang=nl" \  -H "Authorization: Bearer sb_live_..."

Plak het in een assistent en die kent de endpoints, de authenticatie en de vorm van de antwoorden. Eerst lezen

Wat een match is, en wat niet

Een match is een indicatie op basis van de gepubliceerde voorwaarden en de gegevens die je meegeeft. Alleen de bevoegde overheid beslist of iemand in aanmerking komt. Elke maatregel linkt naar de eigen pagina van de overheid, met de datum waarop we ze laatst controleerden.

Starten

Aan de slagEen sleutel, een eerste zoekopdracht en een eerste match voor een onderneming, in curl, JavaScript en Python.AuthenticatieBearer-sleutels, live- en testsleutels, de routes die zonder sleutel antwoorden en een sleutel controleren.

De gegevens

Maatregelen zoekenMaatregelen oplijsten en doorzoeken met filters, één maatregel lezen op id of slug, talen, compacte en volledige weergave, versies en as_of.Het datamodelElk veld van een maatregel, van de aanvraagperiode en financiering tot de voorwaarden en herkomst, en elke vaste waardenlijst.Bronnen en herkomstWaar de maatregelen vandaan komen, wat de herkomstvelden betekenen en welke bronvermelding je toont.

Matching

Een onderneming matchenPOST /v1/match: de gegevens van onderneming en project, wat eruit afgeleid wordt, de vier statussen, de redenen, de ontbrekende gegevens en de raming.Voorwaarden als regelsDe regeltaal: knopen, velden, operatoren en de evaluatie met drie uitkomsten.WatchlistsPortefeuilles van ondernemingen die één keer gematcht worden en opnieuw bij elke gewijzigde maatregel, met match-events.

Actueel blijven

Wijzigingen en versiesDe change feed, eventtypes en categorieën, verschillen per veld, herinneringen voor nakende deadlines, versies en historiek.WebhooksWijzigingen en matches naar je eigen endpoint, met filters, handtekeningcontrole in Node en Python, en nieuwe pogingen.

De API gebruiken

MCP-serverDezelfde zoekfunctie, matching en change feed als tools voor AI-agents, over stateless Streamable HTTP, met clientconfiguratie.PagineringCursors, paginagrootte per plan, sorteervolgordes, en welke lijsten pagineren.FoutenDe foutstructuur en elke foutcode, met de status, de details en wat je eraan doet.Limieten en quotaRequests per seconde, requests en match-evaluaties per maand per plan, de RateLimit-headers en wat er geteld wordt.

Referentie

WijzigingslogWat er in de API veranderde, het nieuwste eerst.

Verder

API-referentieElke operatie uit het OpenAPI-document, met een live explorer.PrijzenDe plannen, uit dezelfde tabel die de API toepast.BronnenElke bron die we lezen.llms.txtDeze documentatie in één tekstbestand, voor een AI-assistent.