Generelt for CPR PrivateSector

Version

v4

Sikkerhedszone

5 – Indeholder fortrolige eller følsomme data

Adgangsniveau

Bruger oprettet med MitID Erhverv, og OAuth Shared Secret eller OAuth Certifikat

GraphQL skema

https://graphql.datafordeler.dk/CPR/custom/PrivateSector/<version>/schema?

Endepunkter for CPR

https://graphql.datafordeler.dk/CPR/custom/PrivateSector/<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)

Tjenester og entiteter

Registret har følgende specialudviklede tjeneste, der skal anmodes om adgang til for at få adgang til CPR:

CustomPrivateSectorPerson (giver adgang til entiteten CPRCustom_PrivateSectorPerson)

Læs også mere om registrets entiteter i objekttypekataloget

Bemærk

Hvis du skal have adgang til GraphQL-tjenesten CustomPrivateSectorPerson, skal det være den eneste valgte tjeneste i feltet ”Entiteter og tjenester” i menuen under Anmodning i Datafordeler Administration. Ingen entiteter skal være valgt.

Anmodninger bliver afslået, hvis der både er valgt GraphQL custom-tjenester og entiteter i samme anmodning.

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's CustomPrivateSectorPerson-tjeneste.

Adgang søges på samme måde som for andre registre med beskyttede data på 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 CustomPrivateSectorPerson-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, 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 CustomPrivateSectorPerson 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 CustomPrivateSectorPerson-tjenesten skal du give en række input, der unikt identificerer en person. Normalt kan du udelukkende hente data på én person ad gangen. Dog er det muligt at hente flere personer ved brug af PNR-liste-søgning. Tjenesten tager følgende inputparametre:

pnr: En liste af op til 100 personnumre. 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 kan kun hente hændelser der er sket inden for de seneste 7 dage.
- Parameteren haen kan tage en eller flere af følgende værdier: "ADRESSEOPLYSNINGER_OG_BESKYTTELSE", "CPRADRESSE", "KONTAKTADRESSE", "NAVN_OG_BESKYTTELSE", "UDREJSEINDREJSE", "VAERGEMAAL"
- Parameteren haenkode kan tage en eller flere af 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" }
    }
  ) {
    statusdato
    statusdatousikkerhedsmarkering
    status
    beskyttelser {
      beskyttelsestype
      status
      virkningfra
    }
    navn {
      adresseringsnavn
      efternavn
      fornavne
      mellemnavn
      status
    }
    vaergemaal {
      vaergenavn
      adresselinie1
      adresselinie2
      adresselinie3r
      adresselinie4
      adresselinie5
      vaergemaalstype
      virkningfra
      virkningfrausikkerhedsmarkering
      status
    }
    udrejseIndrejse {
      cprLandIndrejse {
        kode
        navn
        landekode
        administrativEnhedType {
          typeKode
          typeNavn
        }
      }
      cprLandUdrejse {
        kode
        navn
        landekode
        administrativEnhedType {
          typeKode
          typeNavn
        }
      }
      status
      udenlandsadresselinie1
      udenlandsadresselinie2
      udenlandsadresselinie3
      udenlandsadresselinie4
      udenlandsadresselinie5
      virkningfra
      virkningfrausikkerhedsmarkering
    }
    forsvinding {
      status
      virkningfra
      virkningfrausikkerhedsmarkering
    }
    kontaktadresse {
      adresselinie1
      adresselinie2
      adresselinie3
      adresselinie4
      adresselinie5
      virkningfra
    }
    adresseoplysninger {
      cprAdresse {
        bygningsnummer
        bynavn
        cprkommunekode
        cprkommunenavn
        cprvejkode
        etage
        husnummer
        postdistrikt
        postnummer
        sidedoer
        vejadresseringsnavn
        vejnavn
        daradresse
      }
      conavn
      status
      virkningfra
      virkningfrausikkerhedsmarkering
    }
  }
}

Generelt for CPR PrivateSector

CustomPrivateSectorPerson - til private

Omfang af tjenesten

Opbygning af kald via tjenesten

Total Count