Nieuwe versie OData API

29-05-2026 16:14
Image

Vanaf 12 juni is er een nieuwe versie van de OData API beschikbaar. Deze nieuwe versie heeft een aantal nieuwe namen voor attributen, een nieuwe volgorde waarin data geƫxporteerd wordt en ook een nieuwe URL. De huidige versie zal vanaf 1 augustus niet meer werkzaam zijn. Dat betekent dat je alle OData-queries die je gebruikt voor augustus aan moet passen. In dit bericht lees je meer over de wijzigingen. Aan de SyncFeed API verandert niets.

Nieuwe OData URL 

In de nieuwe versie moet je de OData API bevragen via een nieuwe URL. Het volgende is er nu anders: 

Oude URL  https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0   
Nieuwe URL  https://gegevensmagazijn.tweedekamer.nl/OData/v5  

Let op: vanaf 1 augustus geven queries met de oude URL geen resultaat meer. 

De URL voor de Syncfeed API blijft zoals die nu is. 

Nieuwe namen attributen 

Sommige attributen hebben een nieuwe naam gekregen. Ook vervallen er attributen. Het gebruiken van de oude naam geeft vanaf 1 augustus geen juiste resultaten meer. Ook als je voor augustus al de nieuwe URL van de OData API gebruikt in combinatie met de oude namen, krijg je geen juiste resultaten. 

In de tabel hieronder kan je vinden wat er verandert: 

Tabel  Oude naam attribuut  Nieuwe naam attribuut 
Activiteit  Noot  Notitie 
  VRSNummer  [dit attribuut vervalt] 
  SidVoortouw  [dit attribuut vervalt] 
  Voortouwnaam  VoortouwCommissieNaam 
  Voortouwafkorting  VoortouwCommissieAfkorting 
  Voortouwkortenaam  VoortouwCommissieKorteNaam 
  Voortouwcommissie_Id  VoortouwCommissie_Id 
ActiviteitActor  ActorNaam  Naam 
  ActorFractie  FractieNaam 
  Relatie  Rol 
  SidActor  [dit attribuut vervalt] 
Agendapunt  Noot  Notitie 
  Status  [dit attribuut vervalt] 
Besluit  StemmingsSoort  Tekst 
  BesluitSoort  Soort 
  Opmerking  Notitie 
  AgendapuntZaakBesluitVolgorde  Volgorde 
Commissie  Soort   [dit attribuut vervalt] 
  NaamWebNL  [dit attribuut vervalt] 
  NaamWebEN  [dit attribuut vervalt] 
  Inhoudsopgave  Soort 
CommissieZetel  Gewicht  [dit attribuut vervalt] 
Document  DocumentNummer  Nummer 
  Kamer  [dit attribuut vervalt] 
  Volgnummer  Ondernummer 
  DatumRegistratie  [dit attribuut vervalt] 
  DatumOntvangst  [dit attribuut vervalt] 
  KenmerkAfzender  [dit attribuut vervalt] 
  Organisatie  Kamer 
DocumentActor  ActorNaam  Naam 
  ActorFractie  FractieNaam 
  Relatie  Rol 
  SidActor  [dit attribuut vervalt] 
DocumentVersie  Status  [dit attribuut vervalt] 
  Extensie  Bestandsformaat 
FractieZetel  Gewicht  [dit attribuut vervalt] 
KamerstukDossier  HoogsteVolgnummer  AantalDocumenten 
PersoonContactinformatie  Gewicht  [dit attribuut vervalt] 
PersoonLoopbaan  OmschrijvingNl  OmschrijvingNL 
  OmschrijvingEn  OmschrijvingEN 
  Gewicht  Volgorde 
PersoonNevenfunctie  PersoonId  Persoon_Id 
  PeriodeVan  Van 
  PeriodeTotEnMet  TotEnMet 
  IsActief  Actief 
  VergoedingSoort  Soort 
  VergoedingToelichting  Toelichting 
  Gewicht  Volgorde 
PersoonOnderwijs  OpleidingNl  OpleidingNL 
  OpleidingEn  OpleidingEN 
  Gewicht  Volgorde 
PersoonReis  Gewicht  Volgorde 
Reservering  Nummer  [dit attribuut vervalt] 
  StatusCode  [dit attribuut vervalt] 
  StatusNaam  [dit attribuut vervalt] 
  ActiviteitNummer  [dit attribuut vervalt] 
Stemming  ActorNaam  Naam 
  ActorFractie  FractieNaam 
  SidActorLid  [dit attribuut vervalt] 
  SidActorFractie  [dit attribuut vervalt] 
Vergadering  VergaderingNummer  Nummer 
  Sluiting  Eindtijd 
Zaak  Status  [dit attribuut vervalt] 
  GestartOp  Datum 
  Organisatie  Kamer 
  Grondslagvoorhang  Voorhang 
  Volgnummer  Ondernummer 
  HuidigeBehandelstatus  [dit attribuut vervalt] 
  GrootProject  [dit attribuut vervalt] 
ZaakActor  ActorNaam  Naam 
  ActorFractie  FractieNaam 
  ActorAfkorting  Afkorting 
  Relatie  Rol 
  SidActor  [dit attribuut vervalt] 
Zaal  SysCode  [dit attribuut vervalt] 

Omdat de SyncFeed geen gebruik maakt van attributen, verandert er daar dus niets. 

Nieuwe volgorde 

Naast nieuwe namen hebben sommige attributen ook een nieuwe plek in de volgorde van de resultaten gekregen. Je kan vanaf 12 juni de verschillen met elkaar vergelijken met de queries hieronder. Let op: de namen van de attributen kunnen dus verschillen, zoals eerder aangegeven. 

Oude volgorde  gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/$metadata 
Nieuwe volgorde  gegevensmagazijn.tweedekamer.nl/OData/v5/$Metadata 

Omdat de SyncFeed geen gebruik maakt van attributen, verandert er daar dus niets. 

Documentatie 

In aanloop naar 1 augustus passen wij de gehele documentatie aan. Alle pagina's die nog niet zijn aangepast, krijgen bovenaan een verwijzing naar dit nieuwsbericht. Zodra de documentatie up-to-date is, gaat de verwijzing weg.  

Vragen 

We begrijpen dat deze update veel impact kan hebben. Heb je vragen of kunnen wij je ergens bij helpen? Neem contact met ons op.