{"openapi":"3.0.3","info":{"description":"Tjenesten leverer formuesverdier ved oppslag for én eiers faste eiendom eller andel i boligselskap. Verdiene beregnes basert på boligbruk (primærbolig og sekundærbolig), eller som generell formuesverdi for eiendom som ikke er bolig, der boligbruk ikke er aktuelt.","version":"1.2.0","title":"Formuesverdi fast eiendom API","termsOfService":"https://www.skatteetaten.no/deling/bruksvilkar-for-delingstjenester","contact":{"name":"Brukerstøtte","url":"https://www.skatteetaten.no/deling/kontakt/"}},"externalDocs":{"description":"Dokumentasjon på Skatteetatens GitHub","url":"https://skatteetaten.github.io/api-dokumentasjon/api/formuesverdifasteiendom"},"servers":[{"url":"https://formuesverdifasteiendom.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://formuesverdifasteiendom.api.skatteetaten.no/v1","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:formuesverdifasteiendom"]}],"components":{"securitySchemes":{"maskinporten":{"type":"http","description":"Maskinporten benyttes for autentisering","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"FFE-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstått","example":"Oppgitt rettighetspakke er ugyldig."},"korrelasjonsid":{"type":"string","description":"Korrelasjonsid","example":"123e4567-e89b-12d3-a456-426655440000"}}},"FormuesverdiFastEiendom":{"type":"object","description":"Formuesverdi for fast eiendom med informasjon om adresse, skattleggingsperiode og formuesverdier, inkludert primær og sekundær","properties":{"boenhet":{"description":"boenhet som en fysisk eller juridisk person eier og har bruksrett til i boligselskap eller boligsameie","$ref":"#/components/schemas/BoenhetIBoligselskap"},"type":{"description":"Type svardata datasettet inneholde, som resultat av spørreparameter i forespørselen til APIet.","$ref":"#/components/schemas/Resultattype"},"matrikkelnummer":{"description":"Entydig identifisering av matrikkelenhet innen kommune, definert i matrikkelforskrift § 7e (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e115-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Matrikkelnummer"},"skattleggingsperiode":{"description":"Skattleggingsperiode er et fellesbegrep som brukes om alle former for skatt, og refererer generelt til den perioden som en gitt skattefastsetting gjelder for (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d1-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Inntektsaar"},"tilhoererHovedeiendom":{"description":"Peker til hovedeiendommens matrikkelnummer som denne eiendommen fungerer som tilleggseiendom til. En tilleggseiendom har ikke verdi, og inngår i verdisettingen som ligger på hovedeiendommen.","$ref":"#/components/schemas/HovedeiendomIdentifikator"},"formuesverdiPrimaerbolig":{"description":"Primærbolig er den boligen som eies og benyttes som fast bosted. Dette er vanligvis boligen der folkeregistrert adresse er registrert ved utgangen av inntektsåret. Det kan kun være én primærbolig. Formuesverdien fastsettes som en prosentandel av beregnet eller dokumentert markedsverdi, med en lavere sats for verdier opp til et visst nivå og en høyere sats for den delen som overstiger dette nivået.","$ref":"#/components/schemas/BeloepSomHeltall"},"formuesverdiSekundaerbolig":{"description":"Sekundærbolig er en bolig som eies, men som ikke benyttes som fast bosted ved utgangen av inntektsåret. Eksempler på sekundærboliger inkluderer utleieboliger, pendlerboliger og boliger som brukes som fritidsbolig. En bolig som er fraflyttet før utgangen av inntektsåret på grunn av samlivsbrudd, regnes også som sekundærbolig. Formuesverdien fastsettes med utgangspunkt i beregnet eller dokumentert markedsverdi, i henhold til gjeldende regelverk for skattlegginsperioden.","$ref":"#/components/schemas/BeloepSomHeltall"},"formuesverdi":{"description":"Formuesverdi for øvrig eiendom som ikke klassifiseres som bolig, og dermed ikke kan få beregnet primær- og sekundærverdi","$ref":"#/components/schemas/BeloepSomHeltall"}}},"HovedeiendomIdentifikator":{"type":"object","description":"Identifikator på en hovedeiendom i en samlet relasjon, der hovedeiendommen har data om den samlede verdien for eiendommen pluss tilleggseiendommer som måtte inngå i verdien. Tilleggseiendommer holder ikke på verdi i seg selv, men må ses samlet via hovedeiendom.","properties":{"matrikkelnummer":{"description":"Entydig identifisering av matrikkelenhet innen kommune, definert i matrikkelforskrift § 7e","$ref":"#/components/schemas/Matrikkelnummer"},"boenhetIBoligselskap":{"description":"boenhet som en fysisk eller juridisk person eier og har bruksrett til i boligselskap eller boligsameie","$ref":"#/components/schemas/BoenhetIBoligselskap"}}},"Heltall":{"type":"integer","description":"hele tall, dvs. hele tall i mengden {..., -2, -1, 0, 1, 2, ...} (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52af0-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"int64"},"Organisasjonsnummer":{"type":"string","description":"9 sifret nummer gitt de som er registrert i Enhetsregisteret. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":9,"pattern":"^[0-9]+$","maxLength":9},"BoenhetIBoligselskap":{"type":"object","description":"Boenhet i boligselskap identifiseres ved boligselskapets organisasjonsnummer og andelsnummer eller aksjeboenhetsnummer","properties":{"organisasjonsnummerBoligselskap":{"description":"Organisasjonsnummer til boligselskapet for eiendommen (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e17b-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Organisasjonsnummer"},"andelsnummer":{"description":"Nummer som identifiserer en boenhet i et borettslag (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e178-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"aksjeboenhetsnummer":{"description":"Nummer som identifiserer en boenhet i et boligaksjeselskap og representerer bruksretten som aksjen gir. Aksjeboenhetsnummeret tildeles av Skatteetaten og er registrert i Skatteetatens informasjonssystemer (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e175-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"}}},"Inntektsaar":{"type":"integer","description":"er årstallet som oppgave eller likning gjelder for (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/fa86c460-d685-11e7-9676-0050568351d2'>Begrepsreferanse</a>)","minimum":1000},"BeloepSomHeltall":{"type":"number","format":"double","description":"en sum av penger i hele kroner brukt i en kontekst. Dette kan være en transaksjon, saldo o.l. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e146-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)"},"Matrikkelnummer":{"type":"object","description":"offisiell benevnelse for hver enkel matrikkelenhet (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e115-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","properties":{"kommunenummer":{"description":"nummer for kommune (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e0f3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Kommunenummer"},"gaardsnummer":{"description":"nummer for gård (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e10f-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"bruksnummer":{"description":"fortløpende nummerering innenfor gårdsnummeret (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e102-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"festenummer":{"description":"tas i bruk når et bruksnummer skal deles opp i flere grunneiendommer (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e10a-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"seksjonsnummer":{"description":"nummer på en seksjon (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e124-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"}},"required":["kommunenummer","gaardsnummer","bruksnummer"]},"Kommunenummer":{"type":"string","description":"nummer for kommune (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e0f3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":4,"pattern":"^([0-9]){4}$","maxLength":4},"Resultattype":{"type":"string","description":"Kodeliste over typer resultat dataene representerer når man gjør et kall til tjenesten (<a href='https://data.skatteetaten.no/web/datakatalog/kodeliste/5e651451-12cd-4788-9297-55073a03825e'>Kodelistereferanse</a>)"}}},"paths":{"/{rettighetspakke}/{norskIdentifikator}/{kommunenummer}/{gaardsnummer}/{bruksnummer}":{"get":{"summary":"Hent formuesverdi for fast eiendom med matrikkelnummer.","description":"Hent formuesverdi for fast eiendom med matrikkelnummer.","operationId":"hentFormuesverdiFastEiendomMedMatrikkelnummer","tags":["Formuesverdi fast eiendom"],"parameters":[{"name":"rettighetspakke","in":"path","description":"Datakonsumenter plasseres i en rettighetspakke (per datasett) basert på en juridisk vurdering. Rettighetspakken styrer skjermingsregler, filtrering og detaljering som benyttes når det gis innsyn i data i datasett.","required":true,"schema":{"type":"string"}},{"name":"norskIdentifikator","in":"path","description":"Offentlig norsk identifikator; organisasjonsnummer, fødselsnummer eller D-nummer","required":true,"schema":{"type":"string"},"example":12345678901},{"name":"kommunenummer","in":"path","description":"Nummer for kommune","required":true,"schema":{"type":"string"},"example":"0301"},{"name":"gaardsnummer","in":"path","description":"Nummer for gård","required":true,"schema":{"type":"string"},"example":10},{"name":"bruksnummer","in":"path","description":"Fortløpende nummerering innenfor gårdsnummeret","required":true,"schema":{"type":"string"},"example":10},{"name":"seksjonsnummer","in":"query","description":"Nummer på en seksjon","required":false,"schema":{"type":"string"},"example":10},{"name":"festenummer","in":"query","description":"Tas i bruk når et bruksnummer skal deles opp i flere grunneiendommer","required":false,"schema":{"type":"string"},"example":10},{"name":"Korrelasjonsid","in":"header","description":"Korrelasjonsid, unik identifikator for den tekniske forespørselen. Må være på UUID-format","required":false,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426655440000"}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormuesverdiFastEiendom"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}},"/{rettighetspakke}/{norskIdentifikator}/{organisasjonsnummerBoligselskap}":{"get":{"summary":"Hent formuesverdi for fast eiendom med boenhet i boligselskap.","description":"Hent formuesverdi for fast eiendom med boenhet i boligselskap.","operationId":"hentFormuesverdiFastEiendomMedBoenhetIBoligselskap","tags":["Formuesverdi fast eiendom"],"parameters":[{"name":"rettighetspakke","in":"path","description":"Datakonsumenter plasseres i en rettighetspakke (per datasett) basert på en juridisk vurdering. Rettighetspakken styrer skjermingsregler, filtrering og detaljering som benyttes når det gis innsyn i data i datasett.","required":true,"schema":{"type":"string"}},{"name":"norskIdentifikator","in":"path","description":"Offentlig norsk identifikator; organisasjonsnummer, fødselsnummer eller D-nummer","required":true,"schema":{"type":"string"},"example":12345678901},{"name":"organisasjonsnummerBoligselskap","in":"path","description":"Organisasjonsnummer til boligselskapet for eiendommen","required":true,"schema":{"type":"string"},"example":123456789},{"name":"andelsnummer","in":"query","description":"Nummer som identifiserer en boenhet i et borettslag","required":false,"schema":{"type":"string"},"example":10},{"name":"aksjeboenhetsnummer","in":"query","description":"Nummer som identifiserer en boenhet i et boligaksjeselskap og representerer bruksretten som aksjen gir. Aksjeboenhetsnummeret tildeles av Skatteetaten og er registrert i Skatteetatens informasjonssystemer","required":false,"schema":{"type":"string"},"example":10},{"name":"Korrelasjonsid","in":"header","description":"Korrelasjonsid, unik identifikator for den tekniske forespørselen. Må være på UUID-format","required":false,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426655440000"}],"responses":{"200":{"description":"Gyldig respons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormuesverdiFastEiendom"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}