{"openapi":"3.0.3","info":{"description":"Tjenesten leverer informasjon om ilagt tilleggsskatt ved uriktig, eller manglende innlevering av skattemelding.","version":"1.2.1","title":"Tilleggsskatt 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/tilleggsskatt"},"servers":[{"url":"https://tilleggsskatt.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://tilleggsskatt.api.skatteetaten.no/v1","description":"Produksjon"}],"components":{"schemas":{"Feil":{"description":"Feilstruktur for alle feilmeldinger.","type":"object","properties":{"kode":{"type":"string","description":"Feilkode, for maskinell håndtering","example":"TS-0xx"},"melding":{"type":"string","description":"Beskrivelse av feilen som har oppstaatt","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"}},"Tilleggsskatt":{"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/Foedselsnummer"},"organisasjonsnummer":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Organisasjonsnummer"},"inntektsaar":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/98da432a-dff2-11e7-a0fd-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Aarstall"},"skjermet":{"description":"","$ref":"#/components/schemas/Boolsk"},"vedtakOmTilleggsskatt":{"type":"array","description":"","items":{"$ref":"#/components/schemas/VedtakOmTilleggsskatt"}},"ajourholdstidspunkt":{"description":"","$ref":"#/components/schemas/DatoKlokkeslett"}},"xml":{"name":"tilleggsskatt","namespace":"urn:no:skatteetaten:datasamarbeid:tilleggsskatt:v1"},"anyOf":[{"oneOf":[{"required":["personidentifikator"]},{"required":["organisasjonsnummer"]}]}]},"VedtakOmTilleggsskatt":{"type":"object","description":"","properties":{"skattekommune":{"description":"","$ref":"#/components/schemas/Kommunenummer"},"tilleggsskattFraUriktigeOpplysninger":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d6-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"tilleggsskattFraManglendeInnlevering":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d6-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"skjerpetTilleggsskattFraUriktigeOpplysninger":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d6-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"skjerpetTilleggsskattFraManglendeInnlevering":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d6-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"fradragForTvangsmulkt":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6d9-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Beloep"},"vedtaksdatoForTilleggsskatt":{"description":"(<a href='https://data.skatteetaten.no/web/datakatalog/begrep/6b41c6db-50cd-11e7-b7c5-005056821322'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Dato"}}},"Foedselsnummer":{"type":"string","description":"ellevesifret identifikasjonsnummer for personer bosatt i Norge, der de seks første sifrene angir fødselsdato og de fem siste personnummer. (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/5138da10-be20-11e6-8004-005056825ca0'>Begrepsreferanse</a>)","minLength":11,"pattern":"[0-9]+","maxLength":11},"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},"Aarstall":{"type":"string","description":"årstall er et tall som angir årets nummer i tidsregningen i den gregorianske kalender (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e14a-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"year"},"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>)"},"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"},"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},"Beloep":{"type":"number","description":"en sum av penger 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>)","format":"double"},"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"}}},"paths":{"/{rettighetspakke}/{inntektsaar}/{norskIdentifikator}":{"get":{"summary":"Hent tilleggsskatt for en part","description":"Hent tilleggsskatt for en person eller organisasjon","operationId":"hentTilleggsskattForPart","tags":["Tilleggsskatt"],"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":"inntektsaar","in":"path","description":"Inntektsåret det skal hentes opplysninger fra.","required":true,"schema":{"type":"string"},"example":2020},{"name":"norskIdentifikator","in":"path","description":"identifikator for en person eller enhet (organisasjonsnummer, 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 forespoerselen. 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/Tilleggsskatt"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Tilleggsskatt"}}}},"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"}}}}}}}}}