openapi: 3.1.0
info:
  title: Nasjonale grunndata - Virksomhet
  version: 1.7.0
  description: Verksemder, roller og organisasjonsstruktur
  contact:
    url: https://data.norge.no/ngr/ngr-virksomhet
paths: {}
components:
  schemas:
    Aktivitet:
      additionalProperties: false
      description: Skildring av kva aktivitet ei hovudeining utøver. Svarer til formålsparagrafen
        eller føremålet til verksemda.
      properties:
        aktivitet_beskrivelse:
          description: Skildring av kva aktivitet verksemda utøver (formålsparagraf
            o.l.).
          type: string
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      - aktivitet_beskrivelse
      title: Aktivitet
      type: object
    Beliggenhetsadresse:
      additionalProperties: false
      description: Beliggenheitsadressa til underleininga - den fysiske adressa der
        aktiviteten vert utøvd.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      title: Beliggenhetsadresse
      type: object
    Forretningsadresse:
      additionalProperties: false
      description: Forretningsadressa til hovudeininga - adressa der hovudkontoret
        held til.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      title: Forretningsadresse
      type: object
    GeografiskAdresse:
      additionalProperties: false
      description: Abstrakt klasse for geografiske adresser. Tilhøyrer Domene adresse
        og forvaltast av Matrikkelen. Enhetsregisteret nyttar Kartverket som kjelde
        til vegadresse, og gjer jamnleg vask mot Posten sitt adresseregister.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      title: GeografiskAdresse
      type: object
    Hovedenhet:
      additionalProperties: false
      description: Ei hovudeining er den juridiske eininga registrert i Enhetsregisteret
        (t.d. AS, ENK, BA). Kan ha undereiningar og rolleinnehavarar.
      properties:
        antall_ansatte:
          description: Antal tilsette i verksemda (rapportert til a-ordninga).
          type:
          - integer
          - 'null'
        er_klassifisert_i_naeringskode:
          description: Næringskode(r) verksemda er klassifisert under (1-3).
          items:
            type: string
          minItems: 1
          type: array
        er_klassifisert_i_sektorkode:
          description: Institusjonell sektorkode for hovudeininga.
          type:
          - string
          - 'null'
        er_klassifisert_som_organisasjonsform:
          description: Organisasjonsform (juridisk form) for verksemda.
          type: string
        har_bestemmelser_om_prokura:
          description: Prokurabestemmelse(r) for hovudeininga.
          items:
            type: string
          type:
          - array
          - 'null'
        har_bestemmelser_om_signaturrett:
          description: Bestemmelse om signaturrett for hovudeininga.
          type:
          - string
          - 'null'
        har_forretningsadresse:
          description: Forretningsadressa (hovudkontor) til hovudeininga.
          type:
          - string
          - 'null'
        har_kontaktinformasjon:
          description: Kontaktinformasjon registrert på verksemda.
          type:
          - string
          - 'null'
        har_rolle_i_virksomhet:
          description: Roller registrert i hovudeininga (minimum 1).
          items:
            type: string
          minItems: 1
          type: array
        har_tilstand:
          description: Registrert tilstand (status) for verksemda, inkl. historikk.
          items:
            type: string
          type:
          - array
          - 'null'
        har_varslingsadresse:
          description: Offisiell varslingsadresse for offentlege meldingar.
          type: string
        id:
          description: URI-identifikator for ressursen.
          type: string
        mottar_post_paa:
          description: Postadressa verksemda mottar post på.
          type:
          - string
          - 'null'
        navn:
          description: Registrert namn på verksemda i Enhetsregisteret.
          type: string
        organisasjonsnummer:
          description: Niesifra organisasjonsnummer tildelt av Enhetsregisteret.
          type: string
        stiftelsesdato:
          description: Datoen hovudeininga vart stifta.
          format: date
          type:
          - string
          - 'null'
        utoevar_aktivitet:
          description: Aktiviteten hovudeininga utøver.
          type: string
      required:
      - utoevar_aktivitet
      - har_rolle_i_virksomhet
      - id
      - organisasjonsnummer
      - navn
      - er_klassifisert_som_organisasjonsform
      - har_varslingsadresse
      - er_klassifisert_i_naeringskode
      title: Hovedenhet
      type: object
    Kontaktinformasjon:
      additionalProperties: false
      description: Kontaktinformasjon for verksemda registrert i Enhetsregisteret.
      properties:
        epostadresse:
          description: E-postadresse for verksemda.
          type:
          - string
          - 'null'
        id:
          description: URI-identifikator for ressursen.
          type: string
        mobiltelefonnummer:
          description: Mobiltelefonnummer for verksemda.
          type:
          - string
          - 'null'
        nettside:
          description: URL til nettsida til verksemda.
          type:
          - string
          - 'null'
        telefonnummer:
          description: Telefonnummer for verksemda.
          type:
          - string
          - 'null'
      required:
      - id
      title: Kontaktinformasjon
      type: object
    Naeringskode:
      additionalProperties: false
      description: Næringskode basert på SSBs Standard for næringsgruppering (SN2007/NACE).
        Ei verksemd kan ha 1-3 næringskoder.
      properties:
        er_hovednaeringskode:
          description: Om dette er hovudnæringskoden til verksemda.
          type:
          - boolean
          - 'null'
        id:
          description: URI-identifikator for ressursen.
          type: string
        naeringskode_beskrivelse:
          description: Tekstleg skildring av næringskoden.
          type:
          - string
          - 'null'
        naeringskode_kode:
          description: NACE-kode for næringsgruppering (t.d. 62.010).
          type: string
      required:
      - id
      - naeringskode_kode
      title: Naeringskode
      type: object
    Organisasjonsform:
      additionalProperties: false
      description: Klassifikasjon av juridisk organisasjonsform (t.d. AS, ENK, BA,
        NUF). Kodeverk forvalta av Enhetsregisteret.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        organisasjonsform_beskrivelse:
          description: Tekstleg skildring av organisasjonsforma.
          type:
          - string
          - 'null'
        organisasjonsform_kode:
          description: Kode for organisasjonsform (t.d. AS, ENK, BA, NUF).
          type: string
      required:
      - id
      - organisasjonsform_kode
      title: Organisasjonsform
      type: object
    Person:
      additionalProperties: false
      description: Ein fysisk person. Tilhøyrer Domene person og forvaltast av Folkeregisteret.
        Enhetsregisteret nyttar kopi av data frå Folkeregisteret.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      title: Person
      type: object
    Postadresse:
      additionalProperties: false
      description: Postadressa verksemda mottar post på.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
      required:
      - id
      title: Postadresse
      type: object
    Prokura:
      additionalProperties: false
      description: Prokura gjev ein person fullmakt til å handle på vegne av verksemda
        i næringssaker. Verksemda kan ha fleire prokuraistar.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        prokura_bestemmelse:
          description: Tekstleg bestemmelse om prokura og kven som er tildelt den.
          type: string
      required:
      - id
      - prokura_bestemmelse
      title: Prokura
      type: object
    RolleIVirksomhet:
      additionalProperties: false
      description: Ein definert rolle i ei hovudeining (t.d. dagleg leiar, styreleiar).
        Kvar rolle kan ha éin eller fleire rolleinnehavarar.
      properties:
        har_rolleinnehaver:
          description: Rolleinnehavar(ar) for denne rolla.
          items:
            type: string
          type:
          - array
          - 'null'
        id:
          description: URI-identifikator for ressursen.
          type: string
        rollebetegnelse:
          $ref: '#/components/schemas/RolleType'
          description: Kva type rolle dette er (dagleg leiar, styreleiar o.l.).
      required:
      - id
      - rollebetegnelse
      title: RolleIVirksomhet
      type: object
    RolleType:
      description: Type rolle ein person eller eining kan ha i ei verksemd.
      enum:
      - DAGLIG_LEDER
      - STYRELEDER
      - STYREMEDLEM
      - VARAMEDLEM
      - KONTAKTPERSON
      - KOMPLEMENTAR
      - DELTAKER
      - BESTYRENDE_REDAKTOR
      - FORRETNINGSFORER
      - REVISOR
      - REGNSKAPSFORER
      - NORSK_REPRESENTANT
      title: RolleType
      type: string
    Rolleinnehaver:
      additionalProperties: false
      description: Den som innehar ein rolle i ei verksemd. Kan vere ein fysisk person
        (frå Folkeregisteret) eller ei anna eining.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        kan_vaere_av_type_person:
          description: Personen som er rolleinnehavar (frå Folkeregisteret).
          type:
          - string
          - 'null'
        rolleinnehaver_navn:
          description: Namn på rolleinnehavar (nyttes for institusjonelle rollehavarar).
          type:
          - string
          - 'null'
      required:
      - id
      title: Rolleinnehaver
      type: object
    Sektorkode:
      additionalProperties: false
      description: Institusjonell sektorkode som klassifiserer kva sektor verksemda
        tilhøyrer (t.d. offentleg, privat).
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        sektorkode_beskrivelse:
          description: Tekstleg skildring av sektorkoden.
          type:
          - string
          - 'null'
        sektorkode_kode:
          description: Institusjonell sektorkode (t.d. 1120 for statsforvaltinga).
          type: string
      required:
      - id
      - sektorkode_kode
      title: Sektorkode
      type: object
    Signaturrett:
      additionalProperties: false
      description: Bestemmelse om kven som har rett til å signere på vegne av verksemda
        (t.d. "Styret i fellesskap" eller "Dagleg leiar aleine").
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        signaturrett_bestemmelse:
          description: Tekstleg bestemmelse om signaturrett (t.d. 'Styret i fellesskap').
          type: string
      required:
      - id
      - signaturrett_bestemmelse
      title: Signaturrett
      type: object
    Tilstand:
      additionalProperties: false
      description: Registrert tilstand (status) for ei verksemd i Enhetsregisteret,
        med gyldigheitsperiode for historisk sporing.
      properties:
        gyldig_fra:
          description: Datoen tilstanden vart gyldig frå.
          format: date
          type: string
        gyldig_til:
          description: Datoen tilstanden vart gyldig til.
          format: date
          type:
          - string
          - 'null'
        id:
          description: URI-identifikator for ressursen.
          type: string
        tilstandstype:
          $ref: '#/components/schemas/TilstandType'
          description: Type tilstand (AKTIV, UNDER_KONKURS o.l.).
      required:
      - id
      - tilstandstype
      - gyldig_fra
      title: Tilstand
      type: object
    TilstandType:
      description: Status for ei verksemd registrert i Enhetsregisteret.
      enum:
      - AKTIV
      - UNDER_TVANGSAVVIKLING
      - UNDER_KONKURS
      - AVVIKLET
      - SLETTET
      - OPPLØST
      title: TilstandType
      type: string
    Underenhet:
      additionalProperties: false
      description: Ei underleining er ein geografisk lokasjon der aktiviteten til
        ei hovudeining vert utøvd. Knyt seg til ei hovudeining via organisasjonsnummeret.
      properties:
        antall_ansatte:
          description: Antal tilsette i verksemda (rapportert til a-ordninga).
          type:
          - integer
          - 'null'
        eierskiftedatoer:
          description: Dato(ar) for eigarskifte i underleininga.
          items:
            format: date
            type: string
          type:
          - array
          - 'null'
        er_klassifisert_i_naeringskode:
          description: Næringskode(r) verksemda er klassifisert under (1-3).
          items:
            type: string
          minItems: 1
          type: array
        er_klassifisert_som_organisasjonsform:
          description: Organisasjonsform (juridisk form) for verksemda.
          type: string
        har_beliggenhetsadresse:
          description: Beliggenheitsadressa til underleininga.
          type: string
        har_kontaktinformasjon:
          description: Kontaktinformasjon registrert på verksemda.
          type:
          - string
          - 'null'
        har_tilstand:
          description: Registrert tilstand (status) for verksemda, inkl. historikk.
          items:
            type: string
          type:
          - array
          - 'null'
        har_varslingsadresse:
          description: Offisiell varslingsadresse for offentlege meldingar.
          type: string
        id:
          description: URI-identifikator for ressursen.
          type: string
        mottar_post_paa:
          description: Postadressa verksemda mottar post på.
          type:
          - string
          - 'null'
        navn:
          description: Registrert namn på verksemda i Enhetsregisteret.
          type: string
        nedleggelsesdato:
          description: Datoen underleininga vart lagt ned.
          format: date
          type:
          - string
          - 'null'
        oppstartsdato:
          description: Datoen underleininga vart oppretta/starta.
          format: date
          type: string
        organisasjonsnummer:
          description: Niesifra organisasjonsnummer tildelt av Enhetsregisteret.
          type: string
      required:
      - oppstartsdato
      - har_beliggenhetsadresse
      - id
      - organisasjonsnummer
      - navn
      - er_klassifisert_som_organisasjonsform
      - har_varslingsadresse
      - er_klassifisert_i_naeringskode
      title: Underenhet
      type: object
    VarslingType:
      description: Kanaltype for varsling til verksemda.
      enum:
      - EPOST
      - MOBILTELEFON
      title: VarslingType
      type: string
    Varslingsadresse:
      additionalProperties: false
      description: Offisiell varslingsadresse for verksemda - e-post eller mobilnummer
        som vert brukt for offisielle meldingar frå offentlege styresmakter.
      properties:
        id:
          description: URI-identifikator for ressursen.
          type: string
        varslingstype:
          $ref: '#/components/schemas/VarslingType'
          description: Kanaltype for varsling (EPOST eller MOBILTELEFON).
        varslingsverdi:
          description: Verdien for varslingskanalen (e-postadresse eller mobilnummer).
          type: string
      required:
      - id
      - varslingstype
      - varslingsverdi
      title: Varslingsadresse
      type: object
    Virksomhet:
      additionalProperties: false
      description: Abstrakt overklasse for alle einingar registrert i Enhetsregisteret.
        Ei verksemd er alltid anten ei underleining eller ei hovudeining.
      properties:
        antall_ansatte:
          description: Antal tilsette i verksemda (rapportert til a-ordninga).
          type:
          - integer
          - 'null'
        er_klassifisert_i_naeringskode:
          description: Næringskode(r) verksemda er klassifisert under (1-3).
          items:
            type: string
          minItems: 1
          type: array
        er_klassifisert_som_organisasjonsform:
          description: Organisasjonsform (juridisk form) for verksemda.
          type: string
        har_kontaktinformasjon:
          description: Kontaktinformasjon registrert på verksemda.
          type:
          - string
          - 'null'
        har_tilstand:
          description: Registrert tilstand (status) for verksemda, inkl. historikk.
          items:
            type: string
          type:
          - array
          - 'null'
        har_varslingsadresse:
          description: Offisiell varslingsadresse for offentlege meldingar.
          type: string
        id:
          description: URI-identifikator for ressursen.
          type: string
        mottar_post_paa:
          description: Postadressa verksemda mottar post på.
          type:
          - string
          - 'null'
        navn:
          description: Registrert namn på verksemda i Enhetsregisteret.
          type: string
        organisasjonsnummer:
          description: Niesifra organisasjonsnummer tildelt av Enhetsregisteret.
          type: string
      required:
      - id
      - organisasjonsnummer
      - navn
      - er_klassifisert_som_organisasjonsform
      - har_varslingsadresse
      - er_klassifisert_i_naeringskode
      title: Virksomhet
      type: object
    VirksomhetContainer:
      additionalProperties: false
      description: Rotklasse for NGR-virksomhet-datafiler. Held flate lister av alle
        instansierbare klassar; referansar mellom objekt brukar URI-lenking.
      properties:
        aktivitetar:
          items:
            $ref: '#/components/schemas/Aktivitet'
          type:
          - array
          - 'null'
        beliggenhetsadresser:
          items:
            $ref: '#/components/schemas/Beliggenhetsadresse'
          type:
          - array
          - 'null'
        forretningsadresser:
          items:
            $ref: '#/components/schemas/Forretningsadresse'
          type:
          - array
          - 'null'
        hovedenheter:
          items:
            $ref: '#/components/schemas/Hovedenhet'
          type:
          - array
          - 'null'
        kontaktinformasjon:
          items:
            $ref: '#/components/schemas/Kontaktinformasjon'
          type:
          - array
          - 'null'
        naeringskoder:
          items:
            $ref: '#/components/schemas/Naeringskode'
          type:
          - array
          - 'null'
        organisasjonsformer:
          items:
            $ref: '#/components/schemas/Organisasjonsform'
          type:
          - array
          - 'null'
        postadresser:
          items:
            $ref: '#/components/schemas/Postadresse'
          type:
          - array
          - 'null'
        prokuraer:
          items:
            $ref: '#/components/schemas/Prokura'
          type:
          - array
          - 'null'
        rolleinnehavere:
          items:
            $ref: '#/components/schemas/Rolleinnehaver'
          type:
          - array
          - 'null'
        rollerIVirksomhet:
          items:
            $ref: '#/components/schemas/RolleIVirksomhet'
          type:
          - array
          - 'null'
        sektorkoder:
          items:
            $ref: '#/components/schemas/Sektorkode'
          type:
          - array
          - 'null'
        signaturrettar:
          items:
            $ref: '#/components/schemas/Signaturrett'
          type:
          - array
          - 'null'
        tilstander:
          items:
            $ref: '#/components/schemas/Tilstand'
          type:
          - array
          - 'null'
        underenheter:
          items:
            $ref: '#/components/schemas/Underenhet'
          type:
          - array
          - 'null'
        varslingsadresser:
          items:
            $ref: '#/components/schemas/Varslingsadresse'
          type:
          - array
          - 'null'
      title: VirksomhetContainer
      type: object