{"openapi":"3.0.3","info":{"description":"Tjenesten leverer informasjon om Skatteetaten-registrerte selskap, som er selskap med plikter ovenfor Skatteetaten uten å være registreringspliktige til Enhetsregisteret.","version":"1.0.0","title":"Skatteetaten-registrert selskap 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/skatteetatenregistrertselskap"},"servers":[{"url":"https://skatteetatenregistrertselskap.api.skatteetaten-test.no/v1","description":"Ekstern test"},{"url":"https://skatteetatenregistrertselskap.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":"OAF-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"}}},"SkatteetatenregistrertSelskap":{"type":"object","description":"","properties":{"identifikator":{"description":"Identifikatoren tildeles av Skatteetaten","$ref":"#/components/schemas/Tekst"},"selskapetsNavn":{"description":"Fullt navn på selskapet.","$ref":"#/components/schemas/Tekst"},"virksomhetsrelasjon":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Virksomhetsrelasjon"}},"organisasjonsform":{"description":"","$ref":"#/components/schemas/Tekst"},"stiftelsesdato":{"description":"Dato for stiftelse av selskapet.","$ref":"#/components/schemas/Dato"},"slettetdato":{"description":"Informasjon om når selskapet ble registrert slettet.","$ref":"#/components/schemas/Dato"},"postadresse":{"description":"","$ref":"#/components/schemas/Postadresse"}},"xml":{"name":"skatteetatenregistrertSelskap","namespace":"no:skatteetaten:datasamarbeid:skatteetatenregistrertSelskap"}},"Identifikator":{"type":"object","description":"","properties":{"identifikatortype":{"description":"Typifisering som angir hvillken type identifikator dette er.","$ref":"#/components/schemas/Tekst"},"verdi":{"description":"Identifikatorens innhold.","$ref":"#/components/schemas/Tekst"},"landkode":{"description":"Land som denne identifikatoren tilhører (ISO 3366-1 Alpha-2).","$ref":"#/components/schemas/Landkode"}}},"Metadata":{"type":"object","description":"","properties":{"ajourholdstidspunkt":{"description":"Tidspunkt for når et gitt sett av informasjon ble registrert hos kilde.","$ref":"#/components/schemas/DatoKlokkeslett"},"gyldighetstidspunkt":{"description":"Starttidspunkt for gyldighetsperiode for informasjon hos kilde.","$ref":"#/components/schemas/DatoKlokkeslett"},"opphoerstidspunkt":{"description":"Tidspunkt for når en endring eller status ikke er gyldig lenger.","$ref":"#/components/schemas/DatoKlokkeslett"}}},"Postadresse":{"description":"Forretningsadresse for et selskap angis på ustrukturert format av type AdresseFrittFormat for selskap med adresse i Norge og type InternasjonalAdresse for selskap med adresse i utlandet.","allOf":[{"$ref":"#/components/schemas/Metadata"},{"type":"object","properties":{"norskAdresse":{"description":"","$ref":"#/components/schemas/AdresseFrittFormat"},"utenlandskAdresse":{"description":"","$ref":"#/components/schemas/UtenlandskAdresseFrittFormat"}}}]},"Virksomhetsrelasjon":{"description":"Relasjoner mellom et selskap og andre selskap eller personer.","allOf":[{"$ref":"#/components/schemas/Metadata"},{"type":"object","properties":{"relasjonstype":{"description":"Verdier for rolle eller knytning.","$ref":"#/components/schemas/Tekst"},"relatertIdentifikator":{"description":"","$ref":"#/components/schemas/Identifikator"}}}]},"AdresseFrittFormat":{"type":"object","description":"","properties":{"adressetekst":{"type":"array","description":"(<a href='https://data.skatteetaten.no/begreper/20b2e0fb-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","items":{"$ref":"#/components/schemas/Tekst"}},"postnummer":{"description":"(<a href='https://data.skatteetaten.no/begreper/20b2e121-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Postnummer"},"poststedsnavn":{"description":"(<a href='https://data.skatteetaten.no/begreper/20b2e123-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Tekst"}}},"UtenlandskAdresseFrittFormat":{"type":"object","description":"","properties":{"adressetekst":{"type":"array","description":"(<a href='https://data.skatteetaten.no/begreper/20b2e0fb-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","items":{"$ref":"#/components/schemas/Tekst"}},"postkode":{"description":"(<a href='https://data.skatteetaten.no/begreper/20b2e11f-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Tekst"},"byEllerStedsnavn":{"description":"(<a href='https://data.skatteetaten.no/begreper/20b2e305-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Tekst"},"landkode":{"description":"(<a href='https://data.skatteetaten.no/begreper/20b2e112-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","$ref":"#/components/schemas/Landkode"}}},"Tekst":{"type":"string","description":"vilkårlig lang sekvens av tegn inkludert aksenter og spesielle tegn fra standardiserte tegnsett (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b52af3-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","maxLength":4000},"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},"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"},"Postnummer":{"type":"string","description":"nummer på et poststed (<a href='https://data.skatteetaten.no/web/datakatalog/begrep/20b2e121-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":4,"pattern":"([0-9]){4}","maxLength":4}}},"paths":{"/{rettighetspakke}/{identifikator}":{"get":{"summary":"Hent skatteetaten regsistrert selskap","description":"Informasjon om Skatteetaten-registrerte selskap, som er selskap med plikter ovenfor Skatteetaten uten å være registreringspliktige til Enhetsregisteret.","operationId":"hentSkatteetatenRegistrertSelskap","tags":["skatteetaten registrert selskap"],"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":"identifikator","in":"path","description":"Identifikator på ni siffer tildelt av Skatteetaten.","required":true,"schema":{"type":"string"},"example":"012345678"},{"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/SkatteetatenregistrertSelskap"}}}},"default":{"description":"Alle feil fra applikasjonen kommer på følgende format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}