Patient Management API

FHIR R4 Aligned • Government Submission Ready

Interoperable patient data exchange designed for the NDHI ecosystem. Our endpoints enable seamless movement of medical history across healthcare nodes while ensuring strict data sovereignty.

POST/patients

Create a new patient record aligned with FHIR R4 demographic standards.

Example Request

{
  "first_name": "John",
  "last_name": "Doe",
  "phone": "08012345678",
  "date_of_birth": "1990-01-01",
  "email": "john.doe@example.com",
  "address": "12 Lagos Street, Abuja"
}

Expected Response

{
  "patient_id": "PT-001234",
  "status": "active",
  "created_at": "2026-04-09T10:00:00Z"
}

GET/patients/{id}

Retrieve a comprehensive patient clinical summary including history and compliance status.

Expected Response

{
  "patient_id": "PT-001234",
  "first_name": "John",
  "last_name": "Doe",
  "date_of_birth": "1990-01-01",
  "phone": "08012345678",
  "medical_history": [
    {
      "condition": "Hypertension",
      "diagnosed_date": "2022-03-15",
      "status": "managed"
    },
    {
      "condition": "Malaria",
      "diagnosed_date": "2025-11-20",
      "status": "resolved"
    }
  ],
  "compliance_status": "compliant"
}

NDHI FHIR Endpoints

GET /fhir/Patient/{id}Full FHIR Patient resource

GET /fhir/Encounter/{id}FHIR Encounter (consultation details)

GET /fhir/Observation?patient={id}FHIR lab results and clinical observations

FHIR Example Response

{
  "resourceType": "Patient",
  "id": "PT-001234",
  "name": [{"given": ["John"], "family": "Doe"}],
  "meta": {"profile": ["http://ndhi.gov.ng/fhir/Patient"]}
}

Data Governance

7-Year Retention

In accordance with national health policy, all clinical records are retained for 7 years before automated archival.

Right to Erasure

The DELETE /patients/{id} endpoint allows for data anonymization in compliance with NDPR.