{"openapi":"3.0.3","info":{"description":"Tjeneste for uthenting av hendelser for Mva-register — avgiftssubjekter med skattemeldingsplikt API.","version":"1.1.1","title":"Mva-register — avgiftssubjekter med skattemeldingsplikt hendelser 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/hendelser"},"servers":[{"url":"https://mvaregisterhendelser.api.skatteetaten.no/v1","description":"Ekstern test"},{"url":"https://mvaregisterhendelser.api.skatteetaten.no/v1","description":"Produksjon"}],"security":[{"maskinporten":["skatteetaten:mvaregisteravgiftssubjekt"]}],"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":"MRA-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"}}},"Sekvensnummer":{"type":"object","description":"","properties":{"sekvensnummer":{"description":"","$ref":"#/components/schemas/Heltall"}},"required":["sekvensnummer"]},"MvaRegisterHendelser":{"type":"object","description":"","properties":{"hendelser":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Hendelse"}}},"required":["hendelser"]},"Hendelse":{"type":"object","description":"","properties":{"sekvensnummer":{"description":"","$ref":"#/components/schemas/Heltall"},"skattepliktig":{"description":"","$ref":"#/components/schemas/Organisasjonsnummer"},"registreringstidspunkt":{"description":"","$ref":"#/components/schemas/DatoKlokkeslett"}},"required":["sekvensnummer","skattepliktig","registreringstidspunkt"]},"Heltall":{"type":"integer","description":"hele tall, dvs. hele tall i mengden {..., -2, -1, 0, 1, 2, ...} (<a href='https://data.skatteetaten.no/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/begrep/20b2e1a8-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","minLength":9,"pattern":"[0-9]+","maxLength":9},"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/begrep/20b52aee-9fe1-11e5-a9f8-e4115b280940'>Begrepsreferanse</a>)","format":"date-time"}}},"paths":{"/hendelser":{"get":{"summary":"Hent hendelser for Mva-register — avgiftssubjekter med skattemeldingsplikt API","description":"Hent hendelser for Mva-register — avgiftssubjekter med skattemeldingsplikt API","operationId":"HentHendelserMvaAvgiftssubjekt","tags":["hendelser"],"parameters":[{"name":"fraSekvensnummer","in":"query","description":"Fra og med hvilket sekvensnummer skal spørres etter. Må være større enn 0.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"antall","in":"query","description":"Maks antall ønskede hendelser i responsen. Må være større enn 0.","required":false,"schema":{"type":"integer"}},{"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/MvaRegisterHendelser"}}}},"default":{"description":"Diverse feilmeldinger, se egen dokumentasjon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}},"/hendelser/start":{"get":{"summary":"Hent startpunkt for hendelseslisten","description":"Hent start for hendelseslisten","operationId":"HentStart","tags":["hendelser"],"parameters":[{"name":"dato","in":"query","description":"En dato på ISO 8601-format, YYYY-MM-DD. Dersom dette parameteret er satt vil endepunktet returnere sekvensnummer for første hendelse fra og med denne denne datoen. Dersom dato ikke er satt vil endepunktet returnere sekvensnummer for aller første hendelse i listen.","required":false,"schema":{"type":"string"},"example":"2021-08-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/Sekvensnummer"}}}},"default":{"description":"Diverse feilmeldinger, se egen dokumentasjon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}}}}}}}}