Berikede data i Person‑API

Data i Person‑API kommer i hovedsak fra Folkeregisteret (FREG). Noen opplysninger blir imidlertid beriket med data fra andre kilder – denne siden gir en oversikt over slike berikelser.

Felles kontaktregister (KRR)

Person‑API beriker svarene med informasjon fra Felles kontaktregister (KRR) når personen har data i dette registeret.
KRR‑informasjonen inneholder:

• Foretrukket språk for kommunikasjon
• Telefonnummer
• E‑postadresse
• Digital postkasse som kan benyttes for elektronisk kommunikasjon, eller informasjon om at personen har opt‑out fra digital kommunikasjon.

Person‑API importerer KRR‑data fortløpende, og sender også en ChangeInCommonContactRegisterInformation‑hendelse dersom KRR‑informasjonen for en person endres.

Nedenfor vises et JSON‑eksempel på KRR‑data i et svar fra Person‑API:

"commonContactRegisterInformation": {
    "reservation": "Yes",
    "status": "Active",
    "reservationTime" : "2016-08-05T10:45:15.768Z",
    "reservationUpdated": "2022-08-05T10:45:15.768Z",
    "notificationStatus": "CanNotBeNotified",
    "contactInformation": {
      "email": "01012295312_test@minid.difi.no",
      "emailLastUpdated": "2016-08-05T10:45:15.768Z",
      "emailLastVerified": "2022-08-05T10:45:15.768Z",
      "phoneNumber": "123456789",
      "phoneNumberLastUpdated": "2016-08-05T10:45:15.768Z",
      "phoneNumberLastVerified": "2022-08-05T10:45:15.768Z"
    },
    "digitalPost": {
      "digitalPostAddress": "ola.nordmann#9YDT",
      "digitalPostVendorAddress": "984661185, 922020175"
    },
    "certificate": "X509Certificate",
    "language": "nb",
    "languageLastUpdated": "2022-08-05T10:45:15.768Z"
}

Tilleggsinformasjon om kommune og fylke

For bosteds‑, oppholds‑ og delt‑bosteds‑ adresser, samt opplysninger om sivilstatus og fødsel, gir Folkeregisteret (FREG) kun kommunenummer (kommunenummer). Person‑API beriker disse elementene med flere datapunkter, slik at du får følgende informasjon om kommuner og fylker:

Person‑API bruker klassifikasjonene fra Statistisk sentralbyrå (SSB) for å hente inn denne informasjonen:

• 131 Standard for kommuneinndeling
• 104 Standard for fylkesinndeling

Disse to klassifikasjonene kombineres til et enkelt datasett som knytter alle kommuner til sine tilhørende fylker i Norge. Endringer i kommune‑ eller fylkesinndeling er sjeldne, men datasettet oppdateres daglig i Person‑API.

Datasettet for 2024 kan lastes ned fra følgende URL:

https://data.ssb.no/api/klass/v1/classifications/131/correspondsAt?date=2024-01-01&targetClassificationId=104

Eller du kan hente det som JSON ved å kjøre følgende curl‑kommando:

curl -X "GET" "https://data.ssb.no/api/klass/v1/classifications/131/correspondsAt?date=2024-01-01&targetClassificationId=104" -H "Accept: application/json"

Nedenfor kan du se et JSON‑eksempel på kommune‑ og fylkesinformasjon som er inkludert i opplysningene om sivilstatus.

"maritalStatus": [
    {
        "status": "Married",
        "statusDate": "1991-02-09T00:00:00Z",
        "authority": "DEN_NORSKE_KIRKE",
        "municipalityNumber": "0301",
        "municipalityName": "Oslo",
        "countyNumber": "03",
        "countyName": "Oslo",
        "place": "Sist Testkirke",
        "abroad": null,
        "relatedByMaritalStatus": "13926298253",
        "registeredAt": "2022-03-11T15:35:30.143022Z",
        "isValid": true,
        "source": "Synutopia",
        "reason": "Patch",
        "validFrom": "1991-02-09T15:35:30.143021Z",
        "validTo": null
    }
]

Grunnstatistiske enheter (grunnkrets) og bydel

Her er en kort oversikt over adresser som kan inneholde grunnkrets og bydeler:

Nedenfor vises et JSON‑eksempel på en bostedsadresse som inkluderer grunnkrets, bydel, samt kommune‑ og fylkesinformasjon.

"residentialAddress": [
    {
      "streetAddress": {
        "separatelyOccupiedUnitNumber": "H0101",
        "separatelyOccupiedUnitType": "Housing",
        "addressName": "KONGENS GATE",
        "addressNumber": {
          "houseNumber": "120",
          "houseLetter": "A"
        },
        "addressCode": "01100",
        "addressAdditionalName": null,
        "city": {
          "cityName": "TRONDHEIM",
          "postalCode": "7022"
        },
        "coAddressName": null,
        "municipalityNumber": "5001",
        "municipalityName": "Trondheim - Tråante",
        "countyNumber": "50",
        "countyName": "Trøndelag - Trööndelage"
      },
      "coordinate": {
        "epsgCode": 25833,
        "north": 7273600,
        "east": 454000
      },
      "cadastralAddress": null,
      "unknownResidence": null,
      "cadastralIdentifier": "6344200241",
      "closeCadastralIdentifier": null,
      "addressConfidentiality": "Unclassified",
      "moveDate": "2019-03-18T00:00:00Z",
      "basicStatisticalUnit": 5218,
      "fullBasicStatisticalUnitNumber": "50015218",
      "basicStatisticalUnitName": "MUNKVOLD",
      "constituency": 22,
      "schoolDistrict": 5153,
      "churchDistrict": 1,
      "urbanDistrictCode": "500101",
      "urbanDistrictName": "Midtbyen",
      "geographicalUrbanDistrictCode": "500101",
      "geographicalUrbanDistrictName": "Midtbyen",
      "registeredAt": "2020-03-31T18:41:15Z",
      "isValid": true,
      "source": "KILDE_DSF",
      "reason": "Endring av postnummer, skole-, valg- og grunnkrets",
      "validFrom": "2019-03-17T23:00:00Z",
      "validTo": null
    }
]

Basic Grunnstatistiske enheter (grunnkrets)

I Folkeregisteret (FREG) er kun bostedsadressen garantert å være en virkelig adresse i Norge som finnes i Norsk eiendomsregister (Matrikkelen), og dette er den eneste adressen hvor FREG inkluderer en basic grunnkrets.

For oppholds‑ og delt‑bosteds‑ adresser prøver Person‑API å hente en grunnkrets ved å slå opp adressen i Norsk eiendomsregister‑datasett, men det er ingen garanti for at en treff finnes, og vi kan derfor ikke alltid levere denne informasjonen.

Grunnkrets for adresser leveres i følgende datapunkter for bosteds‑, oppholds‑ og delt‑bostedsadresser:

Adressekoordinater

For bosteds‑, oppholds‑ og delt‑bosteds‑ adresser forsøker Person‑API å legge ved koordinater ved å slå opp adressen i Norsk eiendomsregister‑datasett. Det er imidlertid ingen garanti for at adressen finnes i datasettet, og vi kan derfor ikke alltid levere koordinatene.

Koordinat‑objektet kan være null dersom ingen koordinater finnes. Når koordinater er tilstede, indikerer feltet EpsgCode hvilket koordinatsystem (CRS) som benyttes.

Når mulig beriker API‑et resultatet med EUREF89 UTM‑sone 33 (EPSG:25833), som anbefales av GeoNorge for landsdekkende punktdata.

Bydel (urban districts)

Person‑API inkluderer også data om geografiske og tjenesteytende bydeler for bosteds‑, oppholds‑ og delt‑bosteds‑ adresser. Bydeler kartlegges fra grunnstatistiske enheter, så kun bostedsadresser er garantert å ha denne informasjonen dersom personen bor i en by som har bydeler – dette gjelder per i dag Oslo, Bergen, Stavanger og Trondheim.

Tjenesteytende bydeler

Tjenesteytende bydeler defineres av kommunen, men kun i Oslo er det en forskjell mellom geografiske og tjenesteytende bydeler. På tidspunktet for skrivingen er Marka og Sentrum geografiske bydeler som ikke er tjenesteytende bydeler; personer som bor der får sine kommunale sosial‑ og helsetjenester fra andre bydeler.

For Oslo oppdateres koblingen fra grunnstatistiske enheter til tjenesteytende bydeler manuelt basert på data fra Plan‑ og bygningsetaten i Oslo kommune.

Geografiske bydeler

Geografiske bydeler er definert av Statistisk sentralbyrå (SSB). Person‑API benytter følgende klassifikasjoner fra SSB:

• 1 Standard for delområde‑ og grunnkretsinndeling
• 103 Standard for bydelsinndeling

Disse to klassifikasjonene kombineres til ett datasett som knytter alle statistiske enheter til bydelene i Norge. Datasettet oppdateres daglig i Person‑API. Det gyldige datasettet for 2024 kan lastes ned fra:

https://data.ssb.no/api/klass/v1/classifications/1/correspondsAt?date=2023-01-01&targetClassificationId=103

Eller du kan skrive det ut som JSON ved å kjøre følgende curl‑kommando:

curl -X "GET" "https://data.ssb.no/api/klass/v1/classifications/1/correspondsAt?date=2023-01-01&targetClassificationId=103&includeFuture=true" -H "Accept: application/json"