De dienst GeefHistoriekGezinssamenstelling-02.02 laat de afnemer van het MAGDA-platform toe om de historiek van de gezinssamenstelling van een persoon op te vragen bij de KSZ. Deze bevraging gebeurt op basis van een INSZ-nummer en een Datum.
Deze Datum stuurt de manier waarop de historiek wordt samengesteld. Er zijn 2 varianten:
* Opvraging "Op": In deze variant wordt een "foto" genomen van een historische situatie op de gegeven Datum. Het antwoord bevat in dit geval één (of twee in sommige gevallen) Gezinssamenstelling(en).
* Opvraging "Vanaf": in deze variant wordt de historiek opgebouwd vanaf een zekere datum tot vandaag. Het antwoord kan in dit geval meerdere Gezinssamenstellingen bevatten.
Eens de afnemer de request gelanceerd heeft, wordt de vraag doorgestuurd naar de KSZ. MAGDA ontvangt het antwoord en transformeert dit naar een lijst van één of meerdere Gezinssamenstellingen, die elk weer bestaan uit één of meerdere Gezinsleden. Afhankelijk van de verkregen machtigingen worden bepaalde gegevens al dan niet gefilterd. De lijst van gezinssamenstellingen kan maximaal 250 afzonderlijke gezinssamenstellingen bevatten; elke gezinssamenstelling kan opnieuw uit maximaal 250 afzonderlijke gezinsleden bestaan.
In de v3-service van de KSZ kon gekozen worden om naast de gegevens omtrent gezinssamenstellingen ook de persoonsgegevens van elk gezinslid op te vragen. De v4-service upgrade biedt deze mogelijkheid niet meer. De KSZ retourneert altijd een (beperkte) set persoonsgegevens per gezinslid.