Cooperative Housing (Andelsboliger)

← Tilbage til Hovedside

Overblik

Dette afsnit beskriver de tilgængelige REST-endpoints til søgning og opslag af andelsboliger.

Søgninger returnerer en liste af resultater i JSON-format, som indeholder en unik uuid for hver andelsbolig.

Dette uuid kan efterfølgende benyttes til at hente de fulde summariske oplysninger for andelsboligen i XML-format.

Endpoints

SoegningAdresse

Endpoint URL: andelsbolig/postnummervej

Method

GET

Beskrivelse

Søgning efter andelsboliger ved hjælp af adresseoplysninger (postnummer og vejnavn). Der kan søges med eller uden etage og side/dør.

Input

Query parametre:

postnummer
vejnavn
husnummer (valgfri)
etage (valgfri)
sidedoer (valgfri)

Output

JSON-svar indeholdende en liste af matchende andelsboliger (inkl. uuid).

Fejlhåndtering

Returnerer standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /andelsbolig/postnummervej?postnummer=4000&vejnavn=Bj%C3%B8rneklovej&husnummer=2 HTTP/1.1
accept: */*

Eksempel på svar:

{
    "items": [
        {
            "etage": null,
            "husnummer": "2",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "0265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "5e65b9de-17a2-4d89-83d4-38b57a5a52d5",
            "vejkode": "0480",
            "vejnavn": "Bjørneklovej"
        }
    ]
}

SoegningNavnFoedselsdato

Endpoint URL: andelsbolig/personnavn

Method

GET

Beskrivelse

Søgning efter andelsboliger ved hjælp af debitors navn og fødselsdato.

Input

Query parametre:

navn
fdato

Output

JSON-svar indeholdende en liste af matchende andelsboliger (inkl. uuid).

Fejlhåndtering

Returnerer standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /andelsbolig/personnavn?navn=John%20Doe&fdato=01.01.1970 HTTP/1.1

Eksempel på svar:

{
    "items": [
        {
            "etage": "1",
            "husnummer": "6",
            "kommunenavn": "Københavns Kommune",
            "kommunenummer": "101",
            "postdistrikt": "København N",
            "postnummer": "2200",
            "side": "TH",
            "uuid": "7ff90411-fc48-423e-a3d5-12d86dcf23b7",
            "vejkode": "64",
            "vejnavn": "Ahlmannsgade"
        }
    ]
}

SoegningKommunevej

Endpoint URL: andelsbolig/kommunevej

Method

GET

Beskrivelse

Søgning efter andelsboliger ved hjælp af kommunekode og vejkode. Der kan søges med eller uden etage og side/dør.

Input

Query parametre:

kommunekode
vejkode
husnummer (valgfri)
etage (valgfri)
sidedoer (valgfri)

Output

JSON-svar indeholdende en liste af matchende andelsboliger (inkl. uuid).

Fejlhåndtering

Returnerer standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /andelsbolig/kommunevej?kommunekode=265&vejkode=480&husnummer=2 HTTP/1.1
accept: */*

Eksempel på svar:

{
    "items": [
        {
            "etage": null,
            "husnummer": "2",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "0265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "5e65b9de-17a2-4d89-83d4-38b57a5a52d5",
            "vejkode": "0480",
            "vejnavn": "Bjørneklovej"
        }
    ]
}

SoegningCvr

Endpoint URL: andelsbolig/virksomhed/{cvr}

Method

GET

Beskrivelse

Søgning efter andelsboliger ved hjælp af CVR-nummer.

Input

Path parameter:

cvr

Output

JSON-svar indeholdende en liste af matchende andelsboliger (inkl. uuid).

Fejlhåndtering

Returnerer standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /andelsbolig/virksomhed/15231599 HTTP/1.1
accept: */*

Eksempel på svar:

{
    "items": [
        {
            "etage": "KL",
            "husnummer": "5",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "697cbaf3-89a3-4f5d-a9ad-c37af145ed03",
            "vejkode": "480",
            "vejnavn": "Bjørneklovej"
        },
        {
            "etage": "st",
            "husnummer": "5",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "4d01dcc2-d525-4013-beaa-b38f50502039",
            "vejkode": "480",
            "vejnavn": "Bjørneklovej"
        },
        {
            "etage": "KL",
            "husnummer": "10",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "a884a6db-0f4b-41e8-bbf7-781afdc702f6",
            "vejkode": "480",
            "vejnavn": "Bjørneklovej"
        },
        {
            "etage": "ST",
            "husnummer": "4",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "c23571bb-dbcd-4d7f-85c6-4fed9b899444",
            "vejkode": "480",
            "vejnavn": "Bjørneklovej"
        },
        {
            "etage": "KL",
            "husnummer": "4",
            "kommunenavn": "Roskilde Kommune",
            "kommunenummer": "265",
            "postdistrikt": "Roskilde",
            "postnummer": "4000",
            "side": null,
            "uuid": "83afca38-149d-4b87-b8d8-ca68a6a69cf6",
            "vejkode": "480",
            "vejnavn": "Bjørneklovej"
        }
    ]
}

OpslagUUID

Endpoint URL: andelsbolig/andelsbolig/{uuid}

Method

GET

Beskrivelse

Med et uuid fra et tidligere søgesvar kan man lave et opslag for at hente de fulde summariske oplysninger for andelsboligen. Svarformatet kan styres via valgfrie query parametre.

Input

Path parameter:

uuid

Valgfrie query parametre:

xhtml=true - returnerer svaret som XHTML
tmvXhtml=true - returnerer svaret som TMV XHTML
Hvis ingen angives, returneres svaret som OIO XML (standard)

Output

XML dokument af typen AndelSummariskHentResultat (OIO XML, XHTML eller TMV XHTML afhængigt af parametre).

Formateringen af XHTML- og TMV XHTML-svar er ikke dokumenteret i detaljer og kan ændres uden varsel.

Fejlhåndtering

Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /andelsbolig/andelsbolig/76668740-6d7b-11df-be2b-0800200c9a67?xhtml=false&tmvxhtml=false HTTP/1.1
accept: */*

Eksempel på svar:

<AndelSummariskHentResultat xmlns="http://rep.oio.dk/tinglysning.dk/service/message/elektroniskakt/1/" xmlns:ns="http://rep.oio.dk/tinglysning.dk/schema/elektroniskakt/1/" xmlns:ns1="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:ns2="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/" xmlns:ns3="http://rep.oio.dk/ebxml/xml/schemas/dkcc/2003/02/13/" xmlns:ns4="http://rep.oio.dk/tinglysning.dk/schema/snapshot/1/" xmlns:ns5="http://rep.oio.dk/xkom.dk/xml/schemas/2006/01/06/" xmlns:ns6="http://rep.oio.dk/xkom.dk/xml/schemas/2005/03/15/" xmlns:ns7="http://rep.oio.dk/ebxml/xml/schemas/dkcc/2005/03/15/" xmlns:xd="http://www.w3.org/2000/09/xmldsig#">
    <ns:AndelSummarisk>
        <ns:AndelStamoplysninger>
            <ns1:AndelIdentifikator>
                <ns2:MunicipalityCode>0101</ns2:MunicipalityCode>
                <ns2:StreetCode>6496</ns2:StreetCode>
                <ns3:StreetBuildingIdentifier>9</ns3:StreetBuildingIdentifier>
                <ns3:FloorIdentifier>1</ns3:FloorIdentifier>
                <ns1:SideDoerTekst>TV</ns1:SideDoerTekst>
            </ns1:AndelIdentifikator>
            <ns4:AdresseStruktur>
                <ns5:AddressSpecific>
                    <ns6:AddressAccess>
                        <ns2:MunicipalityCode>0101</ns2:MunicipalityCode>
                        <ns2:StreetCode>6496</ns2:StreetCode>
                        <ns3:StreetBuildingIdentifier>9</ns3:StreetBuildingIdentifier>
                    </ns6:AddressAccess>
                    <ns3:FloorIdentifier>1</ns3:FloorIdentifier>
                    <ns3:SuiteIdentifier>TV</ns3:SuiteIdentifier>
                </ns5:AddressSpecific>
                <ns7:StreetName>Skolevangen</ns7:StreetName>
                <ns7:PostCodeIdentifier>2700</ns7:PostCodeIdentifier>
                <ns7:DistrictName>Brønshøj</ns7:DistrictName>
            </ns4:AdresseStruktur>
        </ns:AndelStamoplysninger>
        <ns1:ModelId>2</ns1:ModelId>
    </ns:AndelSummarisk>
    <ns1:ForespoergselsIdentifikator>
        <ns1:Id>00000000-0000-0000-0000-000000000000</ns1:Id>
    </ns1:ForespoergselsIdentifikator>
    <ns:UdskriftDatoTid>2026-05-19T10:11:06.201+02:00</ns:UdskriftDatoTid>
    <ns:AnmeldelseModtagetIndikator>false</ns:AnmeldelseModtagetIndikator>
    <xd:Signature>
        <xd:SignedInfo>
            <xd:CanonicalizationMethod Algorithm=""/>
            <xd:SignatureMethod Algorithm=""/>
            <xd:Reference>
                <xd:DigestMethod Algorithm=""/>
                <xd:DigestValue/>
            </xd:Reference>
        </xd:SignedInfo>
        <xd:SignatureValue/>
    </xd:Signature>
</AndelSummariskHentResultat>