Adresser i Person‑API
Dette er en oversikt over adressene i Persontjenesten og deres ulike egenskaper.
De tilsvarende norske navnene fra Folkeregisteret (National Population Registry) er nevnt i avsnittene.
Den komplette informasjonsmodellen for Persontjenesten finnes her.
Adressetyper
Persontjenesten har 5 ulike adressetyper, hvorav 3 er adresser en person bor på, og 2 er postadresser:
- Bostedsadresse (Residential address)
- Oppholdsadresse (Present address)
- Delt bosted for barn (Shared residence)
- Postadresse (Postal address)
- Postadresse i utlandet (Foreign postal address)
Nedenfor finner du nærmere beskrivelser av alle adressetypene.
Bostedsadresse
En bostedsadresse er en persons primære bosted. For å ha en bostedsadresse må en person ha personstatus Bosatt. Alle personer med denne statusen skal ha en bostedsadresse.
Tilgjengelige adresseformater
- Vegadresse
- Matrikkeladresse
- Ukjent bosted
Oppholdsadresse
En oppholdsadresse er adressen en person for tiden bor på, dersom de ikke bor på sin bostedsadresse. Siden kun personer med personstatus Bosatt kan ha en bostedsadresse, vil dette også være primæradresse for personer som ikke er Bosatt (for eksempel de med D‑nummer). Denne adressen brukes også når en person bor i et annet land.
Tilgjengelige adresseformater
- Vegadresse
- Matrikkeladresse
- Utenlandsk adresse
Delt bosted
Delt bosted er en adressetype som brukes når et barn med separerte foreldre bor hos begge. Denne adressen vil være den samme som en av foreldrenes bostedsadresse, mens barnets egen bostedsadresse vil tilsvare den andre foreldrenes bostedsadresse.
Adressen inneholder også informasjon om når delingsavtalen er gyldig, med elementene ContractValidFrom og ContractValidTo.
Tilgjengelige adresseformater
- Vegadresse
- Matrikkeladresse
- Ukjent bosted
Postadresse
En postadresse er adressen en person foretrekker at post skal leveres til. Dette kan være en vegadresse, en postboks eller en adresse i fri tekst.
Tilgjengelige adresseformater
- Vegadresse
- Postboksadresse
- Postadresse i fri tekst
Postadresse i utlandet
Postadresse for personer som bor i et annet land.
Tilgjengelige adresseformater
- Utenlandsk adresse
- Postadresse i fri tekst for utlandet
Adresseformater
Her er eksempler og beskrivelser av de forskjellige adresseformatene.
En adresse kan kun inneholde ett av disse formatene om gangen. For å se hvilke adressetyper som bruker hvilke formater, se kapitlet ovenfor.
Vegadresse (Vegadresse)
Dette er den mest vanlige adressetypen, og som navnet antyder inneholder den en adresse med gatenavn, husnummer og bokstav, samt mer.
Json eksempel
"streetAddress": {
"separatelyOccupiedUnitNumber": "H0101",
"separatelyOccupiedUnitType": "Housing",
"addressName": "Olav Nilssons gate",
"addressNumber": {
"houseNumber": "31",
"houseLetter": null
},
"addressCode": "1756",
"addressAdditionalName": null,
"city": {
"cityName": "STAVANGER",
"postalCode": "4009"
},
"coAddressName": null,
"municipalityNumber": "1103",
"municipalityName": "Stavanger",
"countyNumber": "11",
"countyName": "Rogaland"
}
Matrikkeladresse (Cadastral address)
Matrikkeladresser er adresser som ennå ikke har fått en gateadresse fra den norske karttjenesten (Kartverket). Disse adressene har tre tall som definerer adressen innen en kommune:
- municipalityLandNumber – gårdsnummer
- titleNumber – bruksnummer
- leaseholdNumber – festenummer
Json eksempel
"cadastralAddress": {
"separatelyOccupiedUnitNumber": "0",
"separatelyOccupiedUnitType": null,
"cadastralNumber": {
"municipalityLandNumber": 22,
"titleNumber": 1,
"leaseholdNumber": 0,
"municipalityNumber": "3201",
"municipalityName": "Bærum",
"countyNumber": "32",
"countyName": "Akershus"
},
"subNumber": 1,
"addressAdditionalName": null,
"city": {
"cityName": "BEKKESTUA",
"postalCode": "1356"
},
"coAddressName": null
}
Utenlandsk adresse (Foreign address)
Utenlandske adresser brukes når en person bor i et annet land, og inneholder blant annet landskoden der personen bor.
Json eksempel
eksempel:
"foreignAddress": {
"coAddressName": null,
"addressName": "Testadressenavn 174",
"building": "Testbygning 75",
"floorNumber": null,
"housingUnit": null,
"postBox": null,
"postCode": "Testpostkode utland 189",
"cityOrPlaceName": "Fast testby- eller stedsnavn",
"districtName": "Testdistrikt 209",
"region": "Testregion 42",
"countryCode": "VN"
}
Ukjent bosted (Unknown residence)
Elementet unknownResidence brukes når adressen til en person er ukjent.
Json eksempel
"unknownResidence": {
"municipalityNumber": "0301",
"municipalityName": "Oslo",
"countyNumber": "03",
"countyName": "Oslo"
}
Postboksadresse (Post box address)
En postboksadresse brukes for å lokalisere postbokser i postadresser. Her inkluderes både lokasjon og eier av postboksen.
Json eksempel
"postBoxAddress": {
"postBoxOwner": null,
"postBoxIdentification": "Test 15",
"city": {
"cityName": "VESTRE SANDØYA",
"postalCode": "4915"
}
}
Postadresse i fritt format (Free form postal address)
Postadresser i fri tekst er adresser uten et fast format; de lagres som en liste av «address lines».
Json eksempel
"freeFormPostalAddress": {
"addressLine": [
"Granittvegen",
"2270 FLISA",
"Norge"
],
"city": null
},
Internasjonal adresse i fritt format (Free form foreign address)
Samme som postadresse i fritt format, men brukes når noen bor i et annet land og inneholder ekstra informasjon som landskode.
Json eksempel
"freeFormForeignAddress": {
"addressLine": [
"Testadresselinje 1"
],
"postCode": "Testpostkode utland 183",
"cityOrPlaceName": "Farlig testby- eller stedsnavn",
"countryCode": "BB"
}
Adresse‑konfidensialitet
Persontjenesten har 4 nivåer av konfidensialitet:
- Ugradert (Unclassified)
- Klientadresse (Client Address)
- Fortrolig (Confidential)
- Strengt fortrolig (Strictly Confidential)
Nedenfor finner du nærmere beskrivelser av de ulike konfidensialitetsnivåene.
Ugradert
Ugradert er standardnivået for konfidensialitet. Ugraderte adresser krever ingen spesiell behandling eller hensyn.
Hvis en person ikke har en definert adresse‑konfidensialitet, settes den til Ugradert som standard.
Klientadresse
Klientadresse er et konfidensialitetsnivå som brukes for å beskytte personer med adresser som kan avsløre personlig informasjon. Et eksempel er en person som bor på en institusjon som et fengsel eller en psykisk helse‑institusjon, hvor adressen kan avsløre personlige eller medisinske data.
Dette konfidensialitetsnivået gjelder per adresse, så en person kan for eksempel ha en ugradert bostedsadresse og en klientadresse som oppholdsadresse.
En klientadresse er i øvrig identisk med en ugradert adresse:
Json eksempel
"ResidentialAddress": [
{
"streetAddress": {
"separatelyOccupiedUnitNumber": "H0101",
"separatelyOccupiedUnitType": "Housing",
"addressName": "Øverbyvegen",
"addressNumber": {
"houseNumber": "88",
"houseLetter": null
},
"addressCode": "05160",
"addressAdditionalName": null,
"city": {
"cityName": "GJØVIK",
"postalCode": "2819"
},
"coAddressName": null,
"municipalityNumber": "3407",
"municipalityName": "Gjøvik",
"countyNumber": "34",
"countyName": "Innlandet"
},
"coordinate": {
"epsgCode": 25833,
"north": 7273600,
"east": 454000
},
"cadastralAddress": null,
"unknownResidence": null,
"cadastralIdentifier": "48684610",
"closeCadastralIdentifier": null,
"addressConfidentiality": "ClientAddress",
"moveDate": "2022-09-05T00:00:00Z",
"basicStatisticalUnit": 602,
"fullBasicStatisticalUnitNumber": "34070602",
"basicStatisticalUnitName": "Øverby",
"constituency": 4,
"schoolDistrict": 5,
"churchDistrict": 2,
"urbanDistrictCode": null,
"urbanDistrictName": null,
"geographicalUrbanDistrictCode": null,
"geographicalUrbanDistrictName": null,
"registeredAt": "2023-03-31T17:42:10.330251Z",
"isValid": true,
"source": "Matrikkelen",
"reason": "Adresseoppdatering",
"validFrom": "2022-09-04T22:00:00Z",
"validTo": null
}
]
Fortrolig
Fortrolige adresser er adresser som ikke skal være tilgjengelige for private personer eller virksomheter. Kun offentlige institusjoner har tilgang til disse.
Fortrolige adresser gjelder per person, så dersom en person har en fortrolig adresse, er alle personens øvrige adresser også fortrolige. Dette vil også fremkomme i addressProtection‑elementet:
Json eksempel
"addressProtection": [
{
"protectionLevel": "Confidential",
"registeredAt": "2022-12-27T07:01:12.10418Z",
"isValid": true,
"source": "Synutopia",
"reason": "Adressebeskyttelse",
"validFrom": "2022-12-26T23:00:00Z",
"validTo": null
}
]
I Person‑API versjon 3 med FullAccess ser en person med en fortrolig adresse slik ut:
Json eksempel
"ResidentialAddress": [
{
"streetAddress": {
"separatelyOccupiedUnitNumber": null,
"separatelyOccupiedUnitType": null,
"addressName": "Øverbyvegen",
"addressNumber": null,
"addressCode": null,
"addressAdditionalName": null,
"city": null,
"coAddressName": null,
"municipalityNumber": "3407",
"municipalityName": "Gjøvik",
"countyNumber": "34",
"countyName": "Innlandet"
},
"coordinate": {
"epsgCode": 25833,
"north": 7273600,
"east": 454000
},
"cadastralAddress": null,
"unknownResidence": null,
"cadastralIdentifier": null,
"closeCadastralIdentifier": null,
"addressConfidentiality": "Confidential",
"moveDate": "2022-12-27T00:00:00Z",
"basicStatisticalUnit": null,
"fullBasicStatisticalUnitNumber": null,
"basicStatisticalUnitName": null,
"constituency": null,
"schoolDistrict": null,
"churchDistrict": null,
"urbanDistrictCode": null,
"urbanDistrictName": null,
"geographicalUrbanDistrictCode": null,
"geographicalUrbanDistrictName": null,
"registeredAt": "2022-12-27T07:01:12.598443Z",
"isValid": true,
"source": "Synutopia",
"reason": "Flytting innenlands",
"validFrom": "2022-12-26T23:00:00Z",
"validTo": null
}
]
I versjon 3 med Restricted Access og i tidligere versjoner av Person‑API ser en person med en fortrolig adresse slik ut:
Json eksempel
"ResidentialAddress": [
{
"streetAddress": {
"separatelyOccupiedUnitNumber": null,
"separatelyOccupiedUnitType": null,
"addressName": "FORTROLIG ADRESSE",
"addressNumber": null,
"addressCode": null,
"addressAdditionalName": null,
"city": null,
"coAddressName": null,
"municipalityNumber": "0000",
"municipalityName": null,
"countyNumber": null,
"countyName": null
},
"coordinate": {
"epsgCode": 25833,
"north": 7273600,
"east": 454000
},
"cadastralAddress": null,
"unknownResidence": null,
"cadastralIdentifier": null,
"closeCadastralIdentifier": null,
"addressConfidentiality": "Confidential",
"moveDate": "2022-12-27T00:00:00Z",
"basicStatisticalUnit": null,
"fullBasicStatisticalUnitNumber": null,
"basicStatisticalUnitName": null,
"constituency": null,
"schoolDistrict": null,
"churchDistrict": null,
"urbanDistrictCode": null,
"urbanDistrictName": null,
"geographicalUrbanDistrictCode": null,
"geographicalUrbanDistrictName": null,
"registeredAt": "2022-12-27T07:01:12.598443Z",
"isValid": true,
"source": "Synutopia",
"reason": "Flytting innenlands",
"validFrom": "2022-12-26T23:00:00Z",
"validTo": null
}
]
Strengt fortrolig
Strengt fortrolige adresser er kun tilgjengelige for Kripos, og finnes derfor ikke i Persontjenesten.
Personer med en strengt fortrolig adresse vil vanligvis ha en ugradert postadresse med en referanse til en postboks som administreres av Kripos, og som kan brukes for å kontakte personen.
eksempel **address protection** elementet
"addressProtection": [
{
"protectionLevel": "StrictlyConfidential",
"registeredAt": "2022-01-28T08:31:53.359424Z",
"isValid": true,
"source": "Synutopia",
"reason": "Adressebeskyttelse",
"validFrom": "2022-01-28T08:31:53.109305Z",
"validTo": null
}
]
eksempel Postadresse (merk postBoxOwner og addressConfidentiality)
"postalAddress": [
{
"addressConfidentiality": "Unclassified",
"postBoxAddress": {
"postBoxOwner": "SOT 6",
"postBoxIdentification": "Postboks 2094 Vika",
"city": {
"cityName": "OSLO",
"postalCode": "0125"
}
},
"streetAddress": null,
"freeFormPostalAddress": null,
"cadastralIdentifier": null,
"registeredAt": "2023-05-03T12:40:26.8760394Z",
"isValid": true,
"source": "Synutopia",
"reason": "Adressebeskyttelse",
"validFrom": "2022-01-28T08:31:53.109305Z",
"validTo": null
}
]