--- title: "Data-API" description: "Alle cijfers van Rentesneeuwbal.be als JSON, elk met bron en letterlijk citaat: de rente op de Belgische staatsschuld, alleen lezen en zonder sleutel. Geen politiek advies." canonical: https://rentesneeuwbal.be/api last-updated: 2026-09-23 lang: nl-BE --- [Rentesneeuwbal.be](https://rentesneeuwbal.be/) # Data-API Alle cijfers van Rentesneeuwbal.be als JSON, elk met bron en letterlijk citaat. Alleen lezen, zonder sleutel of aanmelding. Geen politiek advies. Alleen officiële cijfers, met de bron erbij. ## Gratis, zonder sleutel De API is gratis. U hebt geen account, geen API-sleutel en geen aanmelding nodig: elke vraag werkt meteen. Alles is alleen lezen, dus u kunt elk endpoint veilig uitproberen op de echte API. ## Adres Elke vraag begint met `https://rentesneeuwbal.be/api/v1`. Het antwoord is JSON in utf-8, met `Access-Control-Allow-Origin: *`, dus ook bruikbaar vanuit een browser. De volledige beschrijving staat in [openapi.json](https://rentesneeuwbal.be/openapi.json) (OpenAPI 3.1). ## Endpoints | Pad | Wat u krijgt | | --- | --- | | `/api/v1` | Overzicht van de API. Naam, versie, datum van de laatste bijwerking en de lijst van endpoints. | | `/api/v1/figures` | Alle cijfers. Alle gesourcete cijfers met waarde, eenheid, jaar, niveau, bron, url, datum en letterlijk citaat. | | `/api/v1/figures/{id}` | Eén cijfer. Eén cijfer met zijn bron en citaat. Voorbeeld: /figures/rente_fed_2026. | | `/api/v1/sources` | Alle bronnen. Elke bron (instelling, document, url, datum) met de cijfers die eruit komen. | | `/api/v1/sources/{id}` | Eén bron. Eén bron met de ids van de cijfers die eruit komen. | | `/api/v1/series` | Alle reeksen. Tijdreeksen met jaren, waarden en bron, zoals: Schuldgraad gezamenlijke overheid 1993-2025 (ESR 2010). | | `/api/v1/series/{id}` | Eén reeks. Eén tijdreeks met jaren, waarden en bron. | | `/api/v1/computed` | Alle berekeningen. Afgeleide cijfers (per seconde, per inwoner, groei) met formule, invoer en uitkomst. | | `/api/v1/computed/{id}` | Eén berekening. Eén afgeleid cijfer met formule, invoer en uitkomst. | ## Voorbeeld ```sh curl https://rentesneeuwbal.be/api/v1/figures/rente_fed_2026 ``` ```json { "id": "rente_fed_2026", "value": 12300000000, "unit": "EUR", "year": 2026, "label": "Rentelasten federale staat 2026 (aangepaste begroting)", "quote": "\"Zij evolueren van 12,3 miljard euro in 2026 naar 17,5 miljard euro in 2029 (+5,2 miljard euro).\" Tabel Evolutie van de intrestlasten 2025-2031: BC 2026 12,3 miljard euro (bronnen: Federaal Agentschap van de Schuld, algemene toelichting, Monitoringcomité)", "scope": "federale overheid", "source": "Rekenhof", "title": "Commentaar en opmerkingen bij de ontwerpen van aanpassing van staatsbegroting voor het begrotingsjaar 2026", "url": "https://www.ccrek.be/sites/default/files/Docs/2026_22_Begroting2026A1.pdf", "date": "2026-05-21", "source_id": "rekenhof-2026-22-begroting2026a1", "links": { "self": "https://rentesneeuwbal.be/api/v1/figures/rente_fed_2026", "source": "https://rentesneeuwbal.be/api/v1/sources/rekenhof-2026-22-begroting2026a1" } } ``` Elk cijfer heeft dezelfde id als in [data.json](https://rentesneeuwbal.be/data.json) en in het attribuut `data-fig` op de pagina's. Vermeld bij elk cijfer de oorspronkelijke bron, het jaar en het niveau (federale overheid of alle overheden samen). Ramingen zijn geen realisaties; de bron en het citaat bij elk cijfer tonen of het om een raming gaat. ## Fouten Een pad dat niet bestaat, geeft status 404 met een foutmelding volgens RFC 9457 (`application/problem+json`): ```json { "type": "https://rentesneeuwbal.be/api#fouten", "title": "Niet gevonden", "status": 404, "detail": "Dit adres bestaat niet in de data-API van Rentesneeuwbal.be. De endpoints staan op https://rentesneeuwbal.be/api/v1 en in https://rentesneeuwbal.be/openapi.json." } ``` ## MCP Dezelfde cijfers zijn er ook als MCP-server voor AI-assistenten: `https://rentesneeuwbal.be/mcp` (Streamable HTTP, alleen lezen, zonder sleutel). De server kent vier tools: een cijfer ophalen, cijfers zoeken, de bronnen tonen en een berekening ophalen. De beschrijving staat in [server-card.json](https://rentesneeuwbal.be/.well-known/mcp/server-card.json). ## A2A en NLWeb Andere agents kunnen dezelfde cijfers ook opvragen met een vraag in gewone woorden. Via A2A stuurt een agent `SendMessage` naar `https://rentesneeuwbal.be/a2a`; de agentkaart staat in [agent-card.json](https://rentesneeuwbal.be/.well-known/agent-card.json). Via NLWeb gaat de vraag naar `https://rentesneeuwbal.be/ask`, en het antwoord komt als JSON of als eventstream. Beide zoeken op trefwoord, zonder taalmodel: dezelfde vraag geeft altijd hetzelfde antwoord. Alle ingangen voor agents staan in [/docs/llms.txt](https://rentesneeuwbal.be/docs/llms.txt). ## Versies De hoofdversie staat in het pad: `/api/v1`. Een wijziging die bestaande gebruikers kan breken, krijgt een nieuw pad (`/api/v2`); nieuwe velden kunnen in v1 bijkomen. Een oude versie blijft na de aankondiging van haar uitfasering minstens zes maanden bereikbaar en krijgt dan de headers `Deprecation` en `Sunset`. Elk antwoord van de API verwijst naar dit beleid met `Link: ; rel="deprecation"`. ## Gebruik Het zijn statische bestanden: er is geen limiet op het aantal verzoeken, maar vraag niet vaker dan nodig. De cijfers veranderen alleen als de site wordt bijgewerkt; `updated` in elk antwoord geeft de datum. Elk antwoord heeft een `ETag`; stuurt u die terug in `If-None-Match`, dan krijgt u `304` zolang er niets veranderde. Licentie: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), met vermelding van Rentesneeuwbal.be en de oorspronkelijke bron. Andere vormen van dezelfde cijfers: [data.json](https://rentesneeuwbal.be/data.json) (alles in één bestand), [llms-full.txt](https://rentesneeuwbal.be/llms-full.txt) (als tekst), [llms.txt voor de API](https://rentesneeuwbal.be/api/llms.txt), en elke pagina als Markdown met de header `Accept: text/markdown`. [Naar de startpagina](https://rentesneeuwbal.be/) [openapi.json](https://rentesneeuwbal.be/openapi.json) [data.json](https://rentesneeuwbal.be/data.json) [llms.txt](https://rentesneeuwbal.be/llms.txt) ## Voor agents - [Alle cijfers als JSON](https://rentesneeuwbal.be/data.json): elk cijfer met waarde, eenheid, jaar, niveau, bron, url, datum en letterlijk citaat. - [Data-API](https://rentesneeuwbal.be/api.md): elk cijfer, elke bron en elke berekening als eigen JSON-adres onder https://rentesneeuwbal.be/api/v1, beschreven in [openapi.json](https://rentesneeuwbal.be/openapi.json). - [llms.txt](https://rentesneeuwbal.be/llms.txt): overzicht van de site; [llms-full.txt](https://rentesneeuwbal.be/llms-full.txt): beide pagina's en alle cijfers in één bestand. - Deze pagina als HTML: https://rentesneeuwbal.be/api - Afgeleide cijfers (per seconde, per inwoner, groei) zijn berekeningen; hun formule, invoer en uitkomst staan in data.json onder `computed` en op https://rentesneeuwbal.be/api/v1/computed. - Alles is openbaar en alleen-lezen. U hebt geen aanmelding of sleutel nodig. - Geen politiek advies. Citeer bij elk cijfer de oorspronkelijke bron, het jaar en het niveau (federale overheid of alle overheden samen). Ramingen zijn geen realisaties; de bron en het citaat bij elk cijfer tonen of het om een raming gaat.