Generelt for CPR GraphQL

Version	v1
Sikkerhedszone	5 – Indeholder fortrolige eller følsomme data
Adgangsniveau	Bruger oprettet med MitID Erhverv, og OAuth Shared Secret eller OAuth Certifikat
GraphQL skemaer	https://graphql.datafordeler.dk/CPR/custom/PrivateSector/v1/schema?
GraphQL skemaer	https://graphql.datafordeler.dk/CPR/custom/PublicSector/v1/schema?
Endepunkt for CPR	https://graphql.datafordeler.dk/CPR/custom/<entitet>/<version>
Dato- og tidsformat	Datoformat følger ISO 8601 Date and time format. Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades. UTC kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z)
Entiteter	Registret har følgende special udviklede entiteter, der skal anmodes om adgang til for at få adgang til CPR: CPRCustom_PrivateSectorPerson CPRCustom_PublicSectorPerson Læs også mere om registrets entiteter i objekttypekataloget

Hvis du ønsker at tilgå CPR-data hos Datafordeleren via GraphQL på vegne af en privat virksomhed, skal du først have adgang til CPR Private Sector-tjenesten.

Tjenesten hedder CustomPrivateSectorPerson og adgang søges på samme måde som for andre registre med beskyttet data hos Datafordeleren.

Tjenesten vælges i drop-down-menuen ”Vælg entiteter og tjenester” når CPR-registeret er valgt i ”Register”-menuen i en almindelig ”Dataadgang”-ansøgning.

”Dataadgang”-ansøgninger er beskrevet yderligere under Anmodning om adgang til beskyttede registerdata .

Med godkendt adgang til CPR Private Sector-tjenesten, har du mulighed for at tilgå entiteten CPRCustom_PrivateSectorPerson via GraphQL. Denne specialudviklede entitet giver mulighed for at tilgå en række af de almindelige entiteter fra CPR-registret og sammenstiller disse, så du ikke selv behøver at tage stilling til hvordan data hænger sammen.

Bemærk at der er en række begrænsninger på hvilke data der kan returneres, som følge af CPR-lovgivningen. Tjenesten udstiller for eksempel udelukkende aktuelle data og der kan ikke hentes data på personer, der har status = ’nedlagt’. Derudover vil adresser, udrejse/indrejse og navn, i tilfælde hvor den pågældende person har navne- og adressebeskyttelse, ikke blive inkluderet i outputtet.

Generelt gælder der de samme regler for udstilling af CPR-data til private anvendere gennem CPR Private Sector som for Datafordelerens nuværende REST-tjenester for private. Du kan læse mere om disse regler på siden REST - private (CPR) (udfases Q2-2026) på Det Centrale Personregister (CPR).

For at bruge CPR Private Sector-tjenesten skal du give en række input der unikt identificerer en person. Dvs. du kan udelukkende hente data på én person ad gangen og denne person skal kunne identificeres unikt ud fra en række inputparametre. Tjenesten tager følgende inputparametre:

pnr: Personnummeret på en person. Parameteren kan ikke bruges sammen med parametrene navn, adresse eller foedselsdato. Kan godt bruges i kombination med parameteren haendelse.
navn: Navnene på en person. Hvis navn benyttes, skal du som minimum angive efternavn sammen med enten fornavn eller mellemnavn. Fornavn, mellemnavn og efternavn kan godt alle bruges samtidig.
adresse: Adressen på en person. Adressen består blandt andet af daradresse, som id’et på den pågældende adresse i Danmarks Adresseregister (DAR). daradresse kan ikke bruges i kombination med nogen af de øvrige adresseparametre. Hvis ikke daradresse angives, skal der angives mindst én fra hver af de følgende punkter:
- kommunekode, postnummer eller postdistrikt
- vejkode, vejnavn eller vejadresseringsnavn
- bygningsnummer eller husnummer
foedselsdato: Den pågældende persons fødselsdato.
haendelse: Hændelser for en person. Kan bruges i kombination med alle de andre parametre. Skal dog overholde følgende regler:
- Hvis dato angives, skal både til- og fra-parametrene angives. Fra-parameteren må ikke være efter til-parameteren og hverken til- eller fra-parameteren må være i fremtiden.
- Du har kun lov til at hente hændelser der er sket inden for de seneste 7 dage.
- Parameteren haen kan kun tage følgende værdier: "ADRESSEOPLYSNINGER_OG_BESKYTTELSE", "CPRADRESSE", "KONTAKTADRESSE", "NAVN_OG_BESKYTTELSE", "UDREJSEINDREJSE", "VAERGEMAAL"
- Parameteren haenkode kan kun tage følgende værdier: "A01", "A02", "A03", "A04", "A05", "A06", "A08", "A09", "A10", "A13", "A14", "A15", "A16", "A17", "A19", "A20", "A21", "A22", "A23", "A24", "A25", "A33", "A34", "A39", "A40", "A42", "A45", "A47", "A73", "A74", "K74", "P02", "P03", "P10", "P11", "P30", "P31", "P42", "P43", "P45"

query {
  CPRCustom_PrivateSectorPerson(
    input: {
      navn: { fornavne: "John", efternavn: "Doe" },
      adresse: {
        postnr: 1550,
        vejnavn: "Rådhuspladsen",
        husnr: "1"
      }
    }
  ) {
    navn {
      fornavne
      mellemnavn
      efternavn
    }
    adresseoplysninger {
      cprAdresse {
        daradresse
        bygningsnummer
        bynavn
        cprkommunekode
        cprvejkode
        etage
        husnummer
        postdistrikt
        postnummer
        sidedoer
        vejadresseringsnavn
        vejnavn
      }
      status
      virkningfra
      virkningfrausikkerhedsmarkering
    }
    beskyttelser {
      beskyttelsestype
      status
      virkningfra
      virkningtil
    }
  }
}

Hvis du ønsker at tilgå CPR-data hos Datafordeleren via GraphQL på vegne af en offentlig myndighed, skal du først have adgang til CPR Public Sector-tjenesten.

Tjenesten hedder CustomPublicSectorPerson og adgang søges på samme måde som for andre registre med beskyttet data hos Datafordeleren.

Tjenesten vælges blot i drop-down-menuen ”Vælg entiteter og tjenester” når CPR-registeret er valgt i ”Register”-menuen i en”Dataadgang”-ansøgning.

”Dataadgang”-ansøgninger er beskrevet yderligere under Anmodning om adgang til beskyttede registerdata .

Med godkendt adgang til CPR Public Sector-tjenesten, har du mulighed for at tilgå entiteten CPRCustom_PublicSectorPerson via GraphQL. Denne specialudviklede entitet giver mulighed for at tilgå en række af de almindelige entiteter fra CPR-registret og sammenstille disse, så du ikke selv behøver at tage stilling til hvordan data hænger sammen.

Bemærk at du med denne tjeneste har mulighed for at hente alle data som CPR har tilgængeligt og der derfor er et dataminimeringsansvar, som ligger hos anvenderen, i kun at hente den data der er nødvendigt for at udføre sin funktion i den tilknyttede myndighed.

Ligesom i CPR Private Sector-tjenesten kan CPR Public Sector tage en række inputparametre. Hvilke inputparametre og datafiltreringer og hvordan disse benyttes, fremgår af det tilhørende GraphQL-skema. I modsætning til den private tjeneste, er der ingen af parametrene der er obligatoriske, da du behøver ikke unikt at kunne identificere en person for at fremsøge informationer om vedkommende og tjenesten kan derfor returnere flere personer samtidig. Du kan for eksempel fremsøge adresseoplysninger for flere personer der hedder ”John Doe” samtidig ved at sende nedenstående GraphQL-query, som en POST-request til https://graphql.datafordeler.dk/CPR/custom/PublicSector/v1:

query {
  CPRCustom_PublicSectorPerson(
    first: 3
    input: { navn: { fornavne: { eq: "John" }, efternavn: { eq: "Doe" } } }
  ) {
    nodes {
      id
      navne {
        fornavne
        mellemnavn
        efternavn
      }
      adresseoplysninger {
        cprAdresse {
          daradresse
          bygningsnummer
          bynavn
          cprkommunekode
          cprvejkode
          etage
          husnummer
          postdistrikt
          postnummer
          sidedoer
          vejadresseringsnavn
          vejnavn
        }
        status
        virkningfra
        virkningfrausikkerhedsmarkering
      }
      beskyttelser {
        beskyttelsestype
        status
        virkningfra
        virkningtil
      }
    }
  }
}

Generelt for CPR GraphQL

CPR Custom entiteter og tjenester

CPR Private Sector - private

Omfang af tjenesten

Opbygning af kald via tjenesten

CPR Public Sector - offentlige

Omfang af tjenesten

Opbygning af kald via tjenesten