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 |
| The ICD-10 code, including the dot (e.g. |
| The ICD-10 description |
| 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 |
| ✅ | The full list of diagnoses |
| ✅ | ICD-10 code, with the dot, e.g. |
| ✅ |
|
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 |
| ICD-10 code strings, e.g. |
Orders (prescription block) |
| 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.
See Webhooks API.
Common Errors
Code | Meaning |
| Invalid request, e.g. a missing |
| Token missing, expired, or invalid |
| You don't have permission to access this resource |
| Patient not found |
| Too many requests |
