Publisert - 20.11.2026

Registrere en fødsel

For å registrere en fødsel sender du en POST-forespørsel til /v1/birth. APIet validerer meldingen, lagrer den og returnerer umiddelbart en messageId som du bruker for å følge status på meldingen.

  • URL: POST /v1/birth
  • Autentisering: Se Autentisering. Krever nhn:birthsystem/write, sikkerhetsnivå 4, HPR-nummer og at personen er jordmor eller lege.
  • Inndata: application/json
  • Utdata: application/json
POST /v1/birth
Authorization: DPoP <access_token>
DPoP: <dpop_proof>
Content-Type: application/json

Forespørsel

Toppnivået i forespørselen består av:

Felt Type Påkreves Beskrivelse
birthDto objekt Ja Detaljene om fødselen. Se birthDto nedenfor.
isCorrectedRequest bool Nei true hvis dette er en korrigering av en tidligere melding. Standard er false.
originalMessageId streng Betinget messageId på den opprinnelige meldingen. Må settes når isCorrectedRequest er true, og må ikke settes ellers.

birthDto

Felt Type Påkreves Beskrivelse
parentsLiveTogether bool Ja Om foreldrene bor sammen.
parentsAreMarried bool Ja Om foreldrene er gift.
numberOfChildrenMultipleBirth heltall Betinget Antall barn ved flerfødsel (2–7). Må settes sammen med barnets multipleBirthSequenceNumber, og det første sifferet i sekvensnummeret må være likt dette tallet.
childDto objekt Ja Barnet. Se childDto.
mother objekt Ja Moren. Se forelder.
fatherOrCoMother objekt Nei Far eller medmor. Samme struktur som mother.
birthPlaceDto objekt Ja Fødested. Se birthPlaceDto.

childDto

Felt Type Påkreves Beskrivelse
dateOfBirth dato Ja Fødselsdato (åååå-mm-dd). Må være innenfor det siste året og kan ikke ligge i fremtiden.
isBornAlive bool Ja Om barnet ble født levende.
multipleBirthSequenceNumber streng Betinget Sekvensnummer ved flerfødsel, f.eks. 21, 22 for tvillinger. Det første sifferet er antall barn, det andre sifferet er rekkefølgen. Må settes sammen med numberOfChildrenMultipleBirth.
gender streng Ja Female eller Male.
hospitalChildIdentificationNumber streng Ja Sykehusets egen identifikator for barnet (maks 200 tegn). Brukes før barnet har fått fødselsnummer, og skal være unik for organisasjonen.

Foreldre (mother og fatherOrCoMother)

En forelder identifiseres på akkurat én av to måter. Feltene for de to måtene er gjensidig eksklusive.

Måte 1 – fødselsnummer (eller D-nummer):

Sett kun nationalIdNumber. Alle de øvrige identifikasjonsfeltene (name, dateOfBirth, citizenship*, norwegianAddress) må ikke settes.

Felt Type Beskrivelse
nationalIdNumber streng Fødselsnummer eller D-nummer (11 siffer).

Når fødselsnummer er oppgitt, henter systemet navnet og fødselsdatoen til forelderen fra Persontjenesten. For moren vil systemet i tillegg avvise forespørselen dersom fødselsnummeret tilhører en person med mannlig kjønn.

Måte 2 – uten fødselsnummer (navn + fødselsdato):

nationalIdNumber må ikke settes. Da kreves følgende:

Felt Type Påkreves Beskrivelse
name objekt Ja Navnet. Se name.
dateOfBirth dato Ja Fødselsdato (åååå-mm-dd). Må være før barnets fødselsdato.
citizenshipIsUnknown bool Ja Om statsborgerskapet er ukjent.
citizenship streng Betinget Landkode (ISO alfa-3, f.eks. SWE). Må settes når citizenshipIsUnknown er false, og må ikke settes når det er true.
norwegianAddress objekt Betinget Norsk adresse. Må settes når citizenshipIsUnknown er false.
isCoMother bool Nei Om forelderen er en medmor. Må være false for mother.

name

Felt Type Påkreves Beskrivelse
firstName streng Ja Fornavn (1–200 tegn).
middleName streng Nei Mellomnavn (1–200 tegn).
lastName streng Ja Etternavn (1–200 tegn).

Navn kan inneholde bokstaver (inkludert nordiske/samiske), mellomrom, bindestrek og apostroffer. Tegnsettet er satt i samsvar med Skatteetatens fødselsmeldingskontrakt.

norwegianAddress

Felt Type Påkreves Beskrivelse
streetName streng Ja Gate og husnummer (maks 4000 tegn).
postalCode streng Ja Postnummer (4 siffer). Må være et gyldig postnummer.

birthPlaceDto

Felt Type Påkreves Beskrivelse
institutionName streng Ja Navnet på fødselsinstitusjonen (maks 200 tegn).
municipalityNumber streng Ja Kommunenummer (4 siffer). Må være et gyldig kommunenummer.

Svar

200 OK

Meldingen er mottatt og lagret.

Felt Type Beskrivelse
messageId GUID ID på fødselsmeldingen. Brukes for statusoppslag og ved korrigering.
hospitalChildIdentificationNumber streng Sykehusets identifikator for barnet (ekko av inndata).
dateTime dato/tid Serverens tidsstempel (UTC).
{
    "messageId": "6d0a3f2e-1b4c-4d5e-8f90-a1b2c3d4e5f6",
    "hospitalChildIdentificationNumber": "12345678910",
    "dateTime": "2026-11-06T08:30:00Z"
}

400 Bad Request

Meldingen feilet validering. Responsen er et ProblemDetails-objekt der title er Validation error og detail inneholder en eller flere feilmeldinger (én per linje). Ukjente felter i forespørselen fører også til 400.

{
    "title": "Validation error",
    "status": 400,
    "detail": "Date of birth cannot be in the future",
    "traceId": "..."
}

401 Unauthorized / 403 Forbidden

Se Autentisering.

409 Conflict

Meldingen kolliderer med allerede registrerte data. Typiske tilfeller:

  • Sykehusets identifikator (hospitalChildIdentificationNumber) er allerede brukt av organisasjonen for en annen fødsel.
  • Det er allerede registrert en fødsel for moren på den angitte datoen. Moren identifiseres etter fødselsnummer, eller etter navn + fødselsdato hvis hun ikke har fødselsnummer.
  • Moren har allerede en enkeltfødsel registrert på datoen, og du sender en flerfødsel (eller omvendt).
  • Korrigeringen peker på en melding som ikke har status godkjent, eller på en melding som allerede er korrigert av en godkjent korrigering.

503 Service Unavailable

Et avhengig system (f.eks. Persontjenesten) var midlertidig utilgjengelig. Prøv på nytt senere.

Validering – oppsummert

Følgende kontrolleres før meldingen registreres. Valideringsfeil gir 400, kollisjoner gir 409:

Område Kontroll
Barnets fødselsdato Må være innenfor det siste året og kan ikke ligge i fremtiden.
Kjønn Må være Female eller Male.
Sykehusets identifikator Må ikke være tom, maks 200 tegn, og må være unik for organisasjonen.
Forelder Må ha enten fødselsnummer eller navn + fødselsdato – ikke begge.
Fødselsnummer 11 siffer med gyldig kontrolltall. Må tilsvare en registrert person (Persontjenesten). Mors fødselsnummer må ha kvinnelig kjønn.
Statsborgerskap Må være gyldig (ISO alfa-3) og eksistere, dersom det er oppgitt.
Postnummer / kommunenummer Må være gyldige (eksistere i referansedata).
Navn / gateadresse Må følge tillatte tegnsett og lengder.
Flerfødsel numberOfChildrenMultipleBirth (2–7) og multipleBirthSequenceNumber må settes sammen og være konsistente. Maks 7 barn.
Foreldrens fødselsdato (uten fødselsnummer) Må være før barnets fødselsdato.
Medmor mother kan ikke være medmor.
Korrigering originalMessageId må være en gyldig GUID og peke på en eksisterende melding når isCorrectedRequest er true. Den opprinnelige meldingen må ha status godkjent og ikke være korrigert av en godkjent korrigering (409).

Referansedata (postnummer, kommunenummer, landkoder) holdes oppdatert automatisk av systemet.

Hvorfor må barnets fødselsdato være innenfor det siste året? For at dette systemet kun skal brukes til nyfødte som skal ha et fødselsnummer, begrenser vi registreringen til barn med fødselsdato innen de siste 12 månedene. Dette er en intern forretningsregel. Folkeregisteret og Skatteetaten stiller ingen aldersbegrensning på fødselsdato; eldre fødsler skal meldes via andre kanaler (f.eks. Folkeregisteret / UDI).

Korrigere en tidligere fødsel

En korrigering sendes som en ny fødselsmelding der isCorrectedRequest er satt til true og originalMessageId peker på messageId til den opprinnelige meldingen. Korrigeringen valideres på samme måte som en ordinær fødsel, men duplikat-sjekkene for ny registrering gjøres ikke ved korrigering – bruk samme hospitalChildIdentificationNumber som i den opprinnelige meldingen.

Den opprinnelige meldingen må ha status godkjent før den kan korrigeres, og korrigeringen må peke på den siste godkjente meldingen i kjeden. Mens en tidligere korrigering fortsatt er under behandling, er avslått eller avvist, eller står til manuell behandling, er originalen fortsatt siste godkjente melding og kan korrigeres på nytt. En korrigering av en ikke-godkjent eller allerede korrigert melding avvises med 409.

Note

En korrigering får sin egen nye messageId. Den opprinnelige meldingen beholdes; korrigeringen er en ny melding som refererer til den. Bruk Status til å følge begge.

Eksempler

Alle eksemplene under forutsetter et gyldig HelseID-token (se Autentisering). Fødselsnumre i eksemplene er fiktive.

Enkel fødsel, begge foreldre med fødselsnummer

{
    "birthDto": {
        "parentsLiveTogether": true,
        "parentsAreMarried": false,
        "childDto": {
            "dateOfBirth": "2026-11-01",
            "isBornAlive": true,
            "gender": "Female",
            "hospitalChildIdentificationNumber": "12345678910"
        },
        "mother": {
            "nationalIdNumber": "30069820006"
        },
        "fatherOrCoMother": {
            "nationalIdNumber": "03019710040"
        },
        "birthPlaceDto": {
            "institutionName": "Rikshospitalet",
            "municipalityNumber": "0301"
        }
    }
}

Enkel fødsel, moren uten fødselsnummer

{
    "birthDto": {
        "parentsLiveTogether": false,
        "parentsAreMarried": false,
        "childDto": {
            "dateOfBirth": "2026-11-01",
            "isBornAlive": true,
            "gender": "Male",
            "hospitalChildIdentificationNumber": "HOSP-2026-000456"
        },
        "mother": {
            "name": {
                "firstName": "Anna",
                "middleName": "Karin",
                "lastName": "Svensson"
            },
            "dateOfBirth": "1990-01-15",
            "citizenshipIsUnknown": false,
            "citizenship": "SWE",
            "norwegianAddress": {
                "streetName": "Storgata 20",
                "postalCode": "0150"
            },
            "isCoMother": false
        },
        "birthPlaceDto": {
            "institutionName": "Sykehuset Innlandet HF",
            "municipalityNumber": "5101"
        }
    }
}

Tvillingfødsel (barn 1 av 2)

{
    "birthDto": {
        "parentsLiveTogether": true,
        "parentsAreMarried": true,
        "numberOfChildrenMultipleBirth": 2,
        "childDto": {
            "dateOfBirth": "2026-11-01",
            "isBornAlive": true,
            "multipleBirthSequenceNumber": "21",
            "gender": "Female",
            "hospitalChildIdentificationNumber": "HOSP-2026-000789-1"
        },
        "mother": {
            "nationalIdNumber": "30069820006"
        },
        "birthPlaceDto": {
            "institutionName": "Sykehuset Østfold HF",
            "municipalityNumber": "0505"
        }
    }
}

Note

Ved flerfødsel sendes én melding per barn, tilsvarende det gamle systemet. Barn 1 av 2 tvillinger får sekvensnummer 21, barn 2 får 22. Feltet numberOfChildrenMultipleBirth er 2 i begge meldingene.

Korrigering av en tidligere fødsel

{
    "isCorrectedRequest": true,
    "originalMessageId": "6d0a3f2e-1b4c-4d5e-8f90-a1b2c3d4e5f6",
    "birthDto": {
        "parentsLiveTogether": true,
        "parentsAreMarried": false,
        "childDto": {
            "dateOfBirth": "2026-11-01",
            "isBornAlive": true,
            "gender": "Male",
            "hospitalChildIdentificationNumber": "12345678910"
        },
        "mother": {
            "nationalIdNumber": "30069820006"
        },
        "birthPlaceDto": {
            "institutionName": "Rikshospitalet",
            "municipalityNumber": "0301"
        }
    }
}

Søk i Utviklerportalen

Søket er fullført!