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"
}
}
}