{"openapi":"3.0.3","info":{"title":"Skatteplikt API","description":"Tjenesten leverer informasjon om type skatteplikt og grunnlag for vurdering av skatteplikten for en person.","version":"2.3.0","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/skatteplikt"},"servers":[{"url":"https://skatteplikt.api.skatteetaten-test.no/v2","description":"Ekstern test"},{"url":"https://skatteplikt.api.skatteetaten.no/v2","description":"Produksjon"}],"paths":{"/{rettighetspakke}/{inntektsaar}/{personidentifikator}":{"get":{"summary":"Hent skatteplikt for person","description":"Hent opplysninger om skatteplikt for en person identifisert av fødsels- eller dnummer.","operationId":"hentSkattepliktForPerson","tags":["Skatteplikt"],"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"},"example":"ssb"},{"name":"inntektsaar","in":"path","description":"Inntektsåret det skal hentes opplysninger fra.","required":true,"schema":{"type":"string"},"example":2021},{"name":"personidentifikator","in":"path","description":"Fødsels- eller Dnummer","required":true,"schema":{"type":"string"},"example":12345678901},{"name":"ajourholdtDato","in":"query","description":"Valgfri parameter på format YYYY-MM-DD. Dersom denne benyttes returneres siste ajourholdte opplysninger for gitt dato.","required":false,"schema":{"type":"string"},"example":"2023-03-21"},{"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/Skatteplikt"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Skatteplikt"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}},"components":{"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"SP-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstått","example":"Fant ikke gitt personidentifikator"},"korrelasjonsid":{"type":"string","description":"Korrelasjonsid","example":"123e4567-e89b-12d3-a456-426655440000"}},"xml":{"name":"feil","namespace":"urn:no:skatteetaten:datasamarbeid:feil:v1"}},"Skatteplikt":{"type":"object","description":"","properties":{"personidentifikator":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4325-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Identifikator"},"inntektsaar":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da432a-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Inntektsaar"},"skjermet":{"description":"","$ref":"#/components/schemas/Boolsk"},"skattested":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da434b-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Kommunenummer"},"skattestedITiltakssone":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4350-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Boolsk"},"personligSkattesubjekt":{"description":"En skattepliktig vil kun få tilslag på enten personligSkattesubjekt eller dødsbo.","$ref":"#/components/schemas/PersonligSkattesubjekt"},"doedsbo":{"description":"En skattepliktig vil kun få tilslag på enten personligSkattesubjekt eller dødsbo.","$ref":"#/components/schemas/Doedsbo"},"ajourholdstidspunkt":{"description":"Tidspunkt for når et sett av informasjon ble registrert hos kilden","$ref":"#/components/schemas/DatoKlokkeslett"}},"xml":{"name":"skatteplikt","namespace":"urn:no:skatteetaten:datasamarbeid:skatteplikt:v2"}},"Doedsbo":{"type":"object","description":"","properties":{"skattepliktTilNorge":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4349-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Skattepliktstype"},"skattepliktTilSvalbard":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da434a-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/SkattepliktstypeSvalbard"},"saerskiltSkatteplikt":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SaerskiltSkatteplikt"}}}},"PersonligSkattesubjekt":{"type":"object","description":"","properties":{"skattepliktTilNorge":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4349-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Skattepliktstype"},"skattepliktTilSvalbard":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da434a-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/SkattepliktstypeSvalbard"},"tolvdelVedArbeidsoppholdINorge":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4353-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"tolvdelForTrinnskatt":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4351-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"alderIInntektsaar":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4314-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"},"borPaaInstitusjon":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4319-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Boolsk"},"datoForForsvunnetEllerDoed":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da431b-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Dato"},"bosattILandEtterSkatteavtale":{"description":"","$ref":"#/components/schemas/Landkode"},"bosattILandEtterSkatteavtaleIEOeS":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4343-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Boolsk"},"fritakForTrygdeavgiftsplikt":{"description":"","$ref":"#/components/schemas/Trygdeavgiftsfritakstype"},"kunTrygdeavgift":{"description":"","$ref":"#/components/schemas/Boolsk"},"tolvdelVedArbeidsoppholdIUtlandet":{"description":"","$ref":"#/components/schemas/Heltall"},"antallMaanederMedOppholdPaaSvalbard":{"description":"","$ref":"#/components/schemas/Antall"},"sambeskatning":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SambeskatningMedAnnenPart"}},"saerskiltSkatteplikt":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SaerskiltSkatteplikt"}}}},"SambeskatningMedAnnenPart":{"type":"object","description":"","properties":{"subjektetsSambeskatningsrolle":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4339-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Sambeskatningsrolle"},"forsoergelsesprosent":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4321-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Prosent"},"identifikator":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da4325-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Identifikator"},"alderIInntektsaar":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/367f2c86-a9e1-11e8-8514-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Heltall"}}},"SaerskiltSkatteplikt":{"type":"object","description":"","properties":{"saerskiltSkatteplikt":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da434f-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/SaerskiltSkattepliktstype"},"satsEtterSkatteavtale":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da433b-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Desimaltall"},"satsEtterBeregningSomBosatt":{"description":"","$ref":"#/components/schemas/Desimaltall"},"skalBeskattesSomBosatt":{"description":"","$ref":"#/components/schemas/Boolsk"},"bosattILandEtterSkatteavtale":{"description":"","$ref":"#/components/schemas/Landkode"},"bosattILandEtterSkatteavtaleIEOeS":{"description":"","$ref":"#/components/schemas/Boolsk"}}},"Sambeskatningsrolle":{"type":"string","description":"","enum":["ektefelle","barn","forelder"]},"Skattepliktstype":{"type":"string","description":"","enum":["global","begrenset","ingenSkatteplikt"]},"SkattepliktstypeSvalbard":{"type":"string","description":"","enum":["global","begrenset","skattepliktUtenOpphold","ingenSkatteplikt"]},"SaerskiltSkattepliktstype":{"type":"string","description":"","enum":["kildeskattepliktPaaPensjon","skattepliktEtterPetroleumsskatteloven","skattepliktSomUtenrikstjenestemann","skattepliktSomSjoemann","skattepliktAvNaeringsdriftEiendomMv","kildeskattepliktPaaLoenn","skattepliktVedUtenriksoppholdINorskStatstjenesteEllerNato","skattepliktPaaLoennFraDenNorskeStatOpptjentIUtlandet"]},"Trygdeavgiftsfritakstype":{"type":"string","description":"","enum":["fulltFritakFraTrygdeavgift","fritakForHelsedel","fritakForPensjonsdel","ingenFritak","ikkeFulltFritakFraTrygdeavgift"]},"Identifikator":{"type":"string","description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e2f8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)"},"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"},"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,"format":"int64"},"Boolsk":{"type":"boolean","description":"angir verdien sann eller usann (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aec-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)"},"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},"DatoKlokkeslett":{"type":"string","description":"en kombinasjon av typene Dato og Klokkeslett. Kodes som en tekststreng etter datoformatering spesifisert i ISO 8601 (ISO 8601:2004 Data elements and interchange formats -- Information interchange -- Representation of dates and times). (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aee-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"date-time"},"Dato":{"type":"string","description":"gir verdier for år, måned og dag. Kodes som en tekststreng etter datoformatering spesifisert i  ISO 8601 (ISO 8601:2004 Data elements and interchange formats -- Information interchange -- Representation of dates and times). Eksempel : 1998-12-21 eller 19981221. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aed-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"date"},"Landkode":{"type":"string","description":"koder for land etter ISO 3166-1 Alpha-2 (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e112-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":2,"pattern":"([A-Z]){2}","maxLength":2},"Antall":{"type":"integer","description":"mengde som utgjør eller kan uttrykkes i et visst tall (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e145-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"int64"},"Desimaltall":{"type":"number","description":"tall som er satt sammen av en heltallsdel og en fraksjondel [wikipedia] (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52aef-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"double"},"Prosent":{"type":"number","description":"Prosent betyr hundredel eller per hundre, og representeres ofte av et tall etterfulgt av tegnet '%'. Prosent er altså en hundredel av en gitt mengde. Eksempelvis vil en prosent av 1000 være 10. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/5d2b8b80-b7e8-11e7-aa27-0050568351d2'>Begrepsreferanse</a>)","format":"double"}}}}