Status
The status-endpoint returns information whether the patient has registered critical health information or not, and a timestamp in UTC time when the information was last changed. A last changed timestamp for each type of critical information is also returned.
The response also contains the privacy settings the patient may have set.
If the patient has set a kjernejournal reservation
no critical information for the patient exists in kjernejournal.
An extra consent must be given for access if the patient has set a restriction
for access to kjernejournal or specifically for critical information.
Note that we prefer that clients requests the status-endpoint first for each session in order to determine whether the patient has set restriction or reservation. This will improve the user experience as extra consent must be given for access in that case. See the nhn-access-basis header for how to set consent.
Authorization
The endpoint requires either a machin-to-machine token or a HelseID user token for authentication. The EPJ can use a machine-to-machine token to check if the patient has critical information and if there has been updates without requiring the user to log in with HelseID.
Note that when a machine-to-machine token is used there are fewer required headers than with a user token.
When a user token is used, the response contains a flag if the users HPR number is blocked or not (see below). This information is not available if a machine-to-machine token is used since it contains no user data.
Also when a user token is used all the required headers must be set as usual. The "nhn-access-basis" header can in this case always be set to UNNTAK. Note that we do not do any audit logging for requests to the /status endpoint.
Input
Attribute | Format | Description |
---|---|---|
nin | String | Norwegian national identification number |
Curl example: Request status for patient
curl --location --request POST 'https://test1.critical-information.hit.nhn.no/api/critical-information/v1/status' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiI......<HelseId machine token>' \
--header 'nhn-source-system: My EPJ system name' \
--header 'nhn-patient-nin: 10086055555' \
--data '{"nin":"10086055555"}'
Response
Attribute | Format | Description |
---|---|---|
patientNIN | String | The patient NIN (National Identification Number). It's the same as FNR/DNR. |
hasCriticalInformation | Boolean | The patient has at least one critical information record which is active (i.e. not deleted or refuted), but it may be expired. |
hasActiveCriticalInformation | Boolean | The patient has at least one critical information record which is active and not expired. |
lastChangedDateTime | Timestamp | Timestamp when critical information was last changed for this patient. |
dateChanged | DateChanged | Date changed for the legacy critical info types. |
criticalInformationStatus | CriticalInformationStatus | Date changed and status per critical info type. More detailed than the legacy dateChanged object. |
privacySetting.hasReservationKjernejournal | Boolean | If the patient has set a kjernejournal reservation or not. |
privacySetting.isRestricted | Boolean | Patient has set restriction for access to critical information. Extra consent must be given for access. |
privacySetting.isBlocked | Boolean | Always false for machine JWTs. True if a user JWT is used and the HPR-number is blocked. Cannot be overruled. |
Attribute DateChanged
Attribute | Format | Description |
---|---|---|
allergyIntoleranceDate | Timestamp | Timestamp when the registration of other allergen (annen allergi) or drug reaction (legemiddelreaksjon) was last changed. |
conditionComplicationsOfAnesthesiaDate | Timestamp | Timestamp when the registration of intubation problems or other anesthetic problems was last changed. |
conditionCriticalMedicalConditionDate | Timestamp | Timestamp when the registration of medical condition alert was last changed. |
procedureDate | Timestamp | Timestamp when the registration of ongoing treatment was last changed. |
deviceUseStatementDate | Timestamp | Timestamp when the registration of (mechanical) device the patient has as implant was last changed. |
conditionTransplantsAndOtherForeignBodiesDate | Timestamp | Timestamp when the registration of transplants and other foreign objects in the body was last changed. |
consentDate | Timestamp | Timestamp when the registration of the consent the patient has given regarding treatment was last changed. |
conditionInfectionDate | Timestamp | Timestamp when the registration of the infectious disease the patient has was last changed. |
flagDate | Timestamp | Timestamp when registration of other procedural changes the patient has was last changed. |
Attribute CriticalInformationStatus
Attribute | Format | Description |
---|---|---|
allergyIntoleranceDrugReaction | ResourceStatus | Resource status allergy drug reaction (legemiddelreaksjon). |
allergyIntoleranceOtherAllergen | ResourceStatus | Resource status allergy other allergen (annen allergi). |
conditionTransplantsAndOtherForeignBodies | ResourceStatus | Resource status transplants and other foreign objects in the body. |
conditionOtherProblemWithAnesthesia | ResourceStatus | Resource status other anesthetic problems was last changed. |
conditionCriticalMedicalCondition | ResourceStatus | Resource status medical condition alert. |
conditionIntubationProblem | ResourceStatus | Resource status intubation problems. |
conditionInfection | ResourceStatus | Resource status infectious disease the patient has. |
consent | ResourceStatus | Resource status consent the patient has given regarding treatment. |
deviceUseStatement | ResourceStatus | Resource status (mechanical) device the patient has as implant. |
procedure | ResourceStatus | Resource status ongoing treatment. |
flag | ResourceStatus | Resource status registration of other procedural changes the patient has. |
Attribute ResourceStatus
Attribute | Format | Description |
---|---|---|
dateChanged | Timestamp | Timestamp when the registration of this critical info type was last changed. |
isActive | Boolean | The patient has at least one critical information record of this type which is active (may be expired). See documentation for each FHIR resource for active-details, e.g. Procedure.status. |
isActiveNotExpired | Boolean | The patient has at least one critical information record of this type which is active and not expired. See documentation for each FHIR resource for expired-details, e.g. Procedure.extension.validUntil. |
Response example patient with only allergyIntolerance drug reaction
{
"patientNIN": "48926561580",
"hasCriticalInformation": true,
"hasActiveCriticalInformation": true,
"lastChangedDateTime": "2025-01-10T21:27:38.025Z",
"dateChanged": {
"allergyIntoleranceDate": "2025-01-10T21:27:37.986Z"
},
"criticalInformationStatus": {
"allergyIntoleranceDrugReaction": {
"dateChanged": "2025-01-10T21:27:37.986Z",
"isActive": true,
"isActiveNotExpired": true
}
},
"privacySetting": {
"hasReservationKjernejournal": false,
"isRestricted": false,
"isBlocked": false
}
}
Response example patient with all types of critical info
{
"patientNIN": "43885702318",
"hasCriticalInformation": true,
"hasActiveCriticalInformation": true,
"lastChangedDateTime": "2025-04-02T09:25:27.188Z",
"dateChanged": {
"allergyIntoleranceDate": "2025-04-02T09:25:26.705Z",
"conditionComplicationsOfAnesthesiaDate": "2025-04-02T09:25:27.188Z",
"conditionCriticalMedicalConditionDate": "2025-04-02T09:25:27.142Z",
"procedureDate": "2025-04-02T09:25:26.85Z",
"deviceUseStatementDate": "2025-04-02T09:25:26.784Z",
"conditionTransplantsAndOtherForeignBodiesDate": "2025-04-02T09:25:27.163Z",
"consentDate": "2025-04-02T09:25:27.001Z",
"flagDate": "2025-04-02T09:25:26.919Z",
"conditionInfectionDate": "2025-04-02T09:25:27.064Z"
},
"criticalInformationStatus": {
"allergyIntoleranceDrugReaction": {
"dateChanged": "2025-04-02T09:25:26.584Z",
"isActive": true,
"isActiveNotExpired": true
},
"allergyIntoleranceOtherAllergen": {
"dateChanged": "2025-04-02T09:25:26.705Z",
"isActive": true,
"isActiveNotExpired": true
},
"conditionTransplantsAndOtherForeignBodies": {
"dateChanged": "2025-04-02T09:25:27.163Z",
"isActive": true,
"isActiveNotExpired": true
},
"conditionOtherProblemWithAnesthesia": {
"dateChanged": "2025-04-02T09:25:27.112Z",
"isActive": true,
"isActiveNotExpired": true
},
"conditionCriticalMedicalCondition": {
"dateChanged": "2025-04-02T09:25:27.142Z",
"isActive": false,
"isActiveNotExpired": false
},
"conditionIntubationProblem": {
"dateChanged": "2025-04-02T09:25:27.188Z",
"isActive": true,
"isActiveNotExpired": true
},
"conditionInfection": {
"dateChanged": "2025-04-02T09:25:27.064Z",
"isActive": true,
"isActiveNotExpired": true
},
"consent": {
"dateChanged": "2025-04-02T09:25:27.001Z",
"isActive": true,
"isActiveNotExpired": true
},
"deviceUseStatement": {
"dateChanged": "2025-04-02T09:25:26.784Z",
"isActive": true,
"isActiveNotExpired": false
},
"procedure": {
"dateChanged": "2025-04-02T09:25:26.85Z",
"isActive": false,
"isActiveNotExpired": false
},
"flag": {
"dateChanged": "2025-04-02T09:25:26.919Z",
"isActive": true,
"isActiveNotExpired": true
}
},
"privacySetting": {
"hasReservationKjernejournal": false,
"isRestricted": true,
"isBlocked": false
}
}