Deze pagina geeft per release weer welke wijzigingen doorgevoerd worden met impact op de publieke API.

Bij elke release vind je 2 data terug: wanneer deze versie beschikbaar komt op de staging omgeving en wanneer deze beschikbaar staat op de productie omgeving.

Voor wijzigingen die geen impact hebben op bestaande implementaties (non-breaking changes zoals extra functionaliteiten, extra velden, …) wordt de release op productie 1 week na de release op staging uitgevoerd.
Voor wijzigingen met impact op bestaande implementaties (breaking changes) worden de release data zowel op staging als op productie ruim op voorhand aangekondigd.

De versie nummering wordt gelijk gehouden voor alle ontwikkelingen van het verenigingsregister. Soms gebeurt het dus dat een nieuwe versie in productie gezet wordt die geen impact heeft op de publieke API. In dat geval gaan we die versie gewoon vermelden, al was het maar om de versie nummers te kunnen controleren.

Het huidige versie nummer van de publieke API vind je terug in de API documentatie. Helemaal onderaan wordt het versie nummer dat nu op die omgeving staat weer gegeven.

API Documentatie Staging omgeving en Productie omgeving

Status van de diensten: zie https://www.vlaanderen.be/digitaal-vlaanderen/status/status-overzicht?product=Verenigingsregister

Versie 8.183.0 automatische adreswijziging door gemeentefusies

Datum staging: Dec 11, 2024

Datum productie: Dec 18, 2024

Automatische adreswijzigingen omwille van gemeentefusies

Op 1 januari 2025 veranderen alle adressen van de fusiegemeenten. Hierbij wordt de gemeentenaam aangepast en soms ook de straatnaam en/of het huisnummer. We luisteren naar deze events van het adressenregister en kijken of er impact is in het verenigingsregister. Elke vereniging uit een van de fusiegemeenten, waarvan het adresId gekend is, zal vanaf 1 januari automatisch het nieuwe adres toegekend krijgen. Dit wordt voor alle adressen met een adresId gedaan, behalve voor de maatschappelijke zetel die uit KBO komt. Daar blijven we luisteren naar wijzigingen die in KBO worden uitgevoerd.

Versie 8.181.1 lidmaatschappen, parameter API voor werkingsgebied, bugfix totalcount

Datum staging: Nov 27, 2024

Datum productie: Dec 4, 2024

Lidmaatschappen

De publieke API bevat nu ook het element lidmaatschappen, waarmee aangegeven kan worden dat de ene vereniging lid is van een andere vereniging. Het lidmaatschap wordt enkel weergegeven bij de vereniging die lid is en dus niet bij de vereniging waarvan die lid is.

Hieronder het voorbeeld bij Publiek detail, ook in de zoek functie kan je de lidmaatschappen terugvinden (daar dan wel zonder het veld naam )

GET <PubliekURL>/v1/verenigingen/<vCode>
{
    "vereniging": {
        "vCode": "<vCode>",
        ...
        "lidmaatschappen": [
            {
                "@id": "lidmaatschap:20a0bce4-b46e-5eb3-9aac-1968f764b34a",
                "@type": "org:Membership",
                "andereVereniging": "<vCode andere vereniging>",
                "naam": "<naam andere vereniging>",
                "identificatie": "<identificatie>",
                "beschrijving": "<beschrijving>",
                "van": "1985-02-11",
                "tot": "2009-03-12"
            }
        ],
        ...
}

Parameter API voor werkingsgebieden

De lijst van mogelijke waarden voor een werkingsgebied kan je terugvinden via de publieke parameter API. Deze call naar de publieke API kan ook zonder API Key uitgevoerd worden.

De mogelijke werkingsgebieden zijn:

de NUTS2 codes voor de provincies van Vlaanderen en voor het Brussels hoofdstedelijke gewest
de NUTS+LAU codes voor de gemeenten van Vlaanderen en van het Brussels hoofdstedelijke gewest
de speciale waarde NVT - Niet van toepassing

GET <PubliekURL>/v1/werkingsgebieden
{
    "werkingsgebieden": [
        {
            "code": "NVT",
            "naam": "Niet van toepassing"
        },
        {
            "code": "BE10",
            "naam": "Brussels Hoofdstedelijk Gewest"
        },
        ...
        {
            "code": "BE23",
            "naam": "Provincie Oost-Vlaanderen"
        },
        ...
        {
            "code": "BE10021001",
            "naam": "Anderlecht"
        },
        ...
        {
            "code": "BE21111001",
            "naam": "Aartselaar"
        },
        ..
}

De speciale waarde NVT betekent dat er geen beperkingen zijn qua werkingsgebied. Dit is vooral om het onderscheid te maken met de default waarde voor werkingsgebieden: de lege lijst []. Deze default waarde geeft eigenlijk aan dat de werkingsgebieden (nog) niet bepaald zijn.

Door het verschil in betekenis kan de waarde NVT niet gecombineerd worden met een andere waarde:

bugfix totalcount

Wanneer het zoekresultaat bij Publiek zoek meer dan 10.000 resultaten bevatte, werd het juiste aantal resultaten niet correct weergegeven in metadata.pagination.totalcount. Daar werd het aantal afgetopt op 10.000. Nu wordt weer het juiste aantal zoek resultaten weergegeven.

Versie 8.163.0 werkingsgebied

Datum staging: Oct 16, 2024

Datum productie: Oct 23, 2024

Werkingsgebied

Een nieuw concept werkingsgebied werd toegevoegd. Dit is een lijst van codes (NUTS&LAU) die aan een vereniging kan toegevoegd worden en die aangeeft welke regio's (gemeente, provincie, …) deze vereniging haar werkingsgebied is.

De huidige werkingsgebieden van een verenigingen kan je terugvinden zowel in publiek detail als via de zoek functie, telkens met zowel de code als de naam. Voorbeeld:

"werkingsgebieden": [
    {
        "@id": "wg:df28db28-1005-5a2f-a892-4495b2f45852",
        "@type": "skos:Concept",
        "code": "BE1",
        "naam": "Brussels Gewest"
    },
    {
        "@id": "wg:66ea53ba-95fd-567f-8610-4761e88a6e8c",
        "@type": "skos:Concept",
        "code": "BE21",
        "naam": "Provincie Antwerpen"
    }
]

In de zoekfunctie kan je de code van het werkingsgebied gebruiken als zoekcriterium. enkele voorbeelden:

Versie 8.154.1 Bugfixes

Datum staging: Oct 3, 2024

Datum productie: Oct 9, 2024

Bugfixes

Er werd een bug gefixt

publieke zoek: wanneer er meer dan 20 facets in de zoekresultaten zitten, worden er toch maar 20 facets getoond

Versie 8.148.0 Export publieke informatie voor externe toepassingen

Datum staging: Sep 18, 2024

Datum productie: Oct 9, 2024

Export publieke informatie voor externe toepassingen

Er is een nieuw endpoint toegevoegd op de publieke API, waarmee externe partijen met specifieke toelating het recht hebben om alle publieke informatie van alle verenigingen op te vragen met 1 streaming endpoint.

Versie 8.146.0 Minimum dataset - Vermijden dat de laatste locatie, vertegenwoordiger of hoofdactiviteit verwijderd wordt

Datum staging: Sep 11, 2024

Datum productie: Oct 9, 2024

Versie 8.133.5.6 Mutatie dienst + initiële adresmatch

Datum staging: Aug 14, 2024

Datum productie: Aug 28, 2024

Versie 8.121.0 Dagelijkse synchronisatie met het adressenregister

Datum staging: Jul 24, 2024

Datum productie: Aug 28, 2024

Versie 8.118.0 synchronisatie met adressenregister + bugfix voor lege locatie naam

Datum staging: Jul 18, 2024

Datum productie: Aug 28, 2024

Versie 8.92.1 Adresmatch op ingevoerde adressen + statuspagina

Datum staging: Apr 30, 2024

Datum productie: May 15, 2024 (verwacht - uitgesteld) - Aug 28, 2024 uitgevoerd

Versie 8.85.8 Bugfix voor de synchronisatie met KBO

Datum staging: Apr 3, 2024

Datum Productie: Apr 10, 2024

Versie 8.85.3 Synchronisatie met KBO, bugfixes voor JSON-LD formaat

Datum Staging: Mar 18, 2024

Datum productie: Mar 25, 2024(geannuleerd)

Versie 8.78.0 Verbeteringen aan het sorteren in publieke zoek, output in JSON-LD formaat

Datum Staging: Mar 4, 2024

Datum productie: Mar 11, 2024

Versie 8.53.3 - geen impact op publieke API

Datum productie: Feb 5, 2024

Versie 8.52.0 - verbeteren publieke zoek resultaten, toevoegen korte beschrijving aan publieke zoek

Datum productie: Jan 26, 2024

Basisregisters

Release notes - Publieke API

Versie 8.183.0 automatische adreswijziging door gemeentefusies

Automatische adreswijzigingen omwille van gemeentefusies

Versie 8.181.1 lidmaatschappen, parameter API voor werkingsgebied, bugfix totalcount

Lidmaatschappen

Parameter API voor werkingsgebieden

bugfix totalcount

Versie 8.163.0 werkingsgebied

Werkingsgebied

Versie 8.154.1 Bugfixes

Bugfixes

Versie 8.148.0 Export publieke informatie voor externe toepassingen

Export publieke informatie voor externe toepassingen

Versie 8.146.0 Minimum dataset - Vermijden dat de laatste locatie, vertegenwoordiger of hoofdactiviteit verwijderd wordt

Versie 8.133.5.6 Mutatie dienst + initiële adresmatch

Versie 8.121.0 Dagelijkse synchronisatie met het adressenregister

Versie 8.118.0 synchronisatie met adressenregister + bugfix voor lege locatie naam

Versie 8.92.1 Adresmatch op ingevoerde adressen + statuspagina

Versie 8.85.8 Bugfix voor de synchronisatie met KBO

Versie 8.85.3 Synchronisatie met KBO, bugfixes voor JSON-LD formaat

Versie 8.78.0 Verbeteringen aan het sorteren in publieke zoek, output in JSON-LD formaat

Versie 8.53.3 - geen impact op publieke API

Versie 8.52.0 - verbeteren publieke zoek resultaten, toevoegen korte beschrijving aan publieke zoek

Related pages