Skip to main content

Patient Diagnoses via API

View and update the diagnosis codes on a patient record.

Diagnoses on the patient record are used throughout NikoHealth, including on prescriptions and orders.


Get a Patient's Diagnoses

GET /v1/patients/{id}/diagnoses
GET /v1/patients/10000056/diagnoses
{
"Items": [
{
"Diagnosis": { "Id": "G47.33", "Name": "Obstructive sleep apnea (adult) (pediatric)" },
"AdditionDate": "2026-11-02T00:00:00"
}
]
}

Field

Description

Diagnosis.Id

The ICD-10 code, including the dot (e.g. G47.33)

Diagnosis.Name

The ICD-10 description

AdditionDate

When the diagnosis was added to the patient


Update a Patient's Diagnoses

POST /v1/patients/{id}/diagnoses

⚠️ This endpoint updates the patient's whole diagnosis list. Include every diagnosis the patient should have, not just the new one. To add a diagnosis, get the current list first, add the new code, and send the full list back.

Fields

Field

Required

Notes

Items

✅

The full list of diagnoses

Items[].Diagnosis

✅

ICD-10 code, with the dot, e.g. G47.33

Items[].AdditionDate

✅

YYYY-MM-DD

Example: add a new diagnosis while keeping the existing one

POST /v1/patients/10000056/diagnoses
{
"Items": [
{ "Diagnosis": "G47.33", "AdditionDate": "2026-11-02" },
{ "Diagnosis": "J44.9", "AdditionDate": "2026-11-10" }
]
}

Response: 200 OK


Using Diagnoses Elsewhere

Where

Field

Format

Prescriptions

DiagnosisCodes

ICD-10 code strings, e.g. ["G47.33"]

Orders (prescription block)

Prescription.Products[].Primitive.DiagnosisCodes

ICD-10 code strings

💡 Use the same ICD-10 codes on prescriptions that appear on the patient's diagnosis list.


Get Notified of Changes

Subscribe to the patient.diagnosis.updated webhook to be notified when a patient's diagnoses change.


Common Errors

Code

Meaning

400

Invalid request, e.g. a missing Diagnosis or AdditionDate, or an unrecognized ICD-10 code

401

Token missing, expired, or invalid

403

You don't have permission to access this resource

404

Patient not found

429

Too many requests


Related articles

Did this answer your question?