Historische voorkomens van bag objecten opvragen

Hi,

ik vind het een hele mooie stap om historische voorkomens van een bag object te kunnen opvragen. Maar ik vraag mij af of deze functionaliteit al goed werkt.

Onderstaande url levert 2 voorkomens op (zie json).
https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010000989488/voorkomens

Ik verwacht dat onderstaande url maar 1 voorkomen oplevert, omdat het 2e voorkomen op die datum nog niet bestond. Maar toch krijg ik de 2 zelfde voorkomens terug.
https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010000989488/voorkomens?geldigOp=2011-08-29

Is hier een verklaring voor? Word wel begingeldigheid en eindgeldigheid om het voorkomen te bepalen gebruikt?

dank Rob

{
"_embedded": {
    "voorkomens": [
        {
            "beginGeldigheid": "2010-09-09T00:00:00.000+02:00",
            "eindGeldigheid": "2013-02-23T00:00:00.000+01:00",
            "inOnderzoek": false,
            "geconstateerd": false,
            "aanduidingInactief": false,
            "aanduidingCorrectie": 0,
            "label": "Voorkomen Verblijfsobject 0363010000989488 van 2010-09-09",
            "_embedded": {
                "bron": {
                    "documentnummer": "GV00000406",
                    "documentdatum": "2010-09-09"
                }
            },
            "_links": {
                "verblijfsobject": {
                    "href": "https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010000989488"
                }
            }
        },
        {
            "beginGeldigheid": "2013-02-23T00:00:00.000+01:00",
            "eindGeldigheid": null,
            "inOnderzoek": false,
            "geconstateerd": false,
            "aanduidingInactief": false,
            "aanduidingCorrectie": 0,
            "label": "Voorkomen Verblijfsobject 0363010000989488 van 2013-02-23",
            "_embedded": {
                "bron": {
                    "documentnummer": "GV00001616_AC00AC",
                    "documentdatum": "2013-02-04"
                }
            },
            "_links": {
                "verblijfsobject": {
                    "href": "https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010000989488"
                }
            }
        }
    ]
}

}

geldigOp is geen geldige parameter op de /voorkomens call. Met /voorkomens haal je alle voorkomens op (zie ook de API reference). geldigOp is wel geldig op resource en collectie.

Bedankt.
Inderdaad gelukt.
https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010000989488?geldigOp=2011-01-01
https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten?geldigOp=2011-01-01

2 likes

Horen de links bij de voorkomens niet te verwijzen naar de betreffende cyclus? Ze verwijzen nu allemaal naar de meest recente cyclus. Ik zou hier geldigOp=… achter alle links verwachten.