Skip to content
PHB/Public Health Bureau
ENEnglishSign inCreate an HPN →
For providers Integration

Your existing HIS keeps working.
PHB speaks FHIR.

HL7 FHIR R4 is the data standard. Your existing hospital information system connects via open-source adapters — no rip-and-replace required.

Read the docs →Request API access
FHIR-native

Built on the global health data standard.

HL7 FHIR R4 is PHB’s data lingua franca. Every patient resource, clinical event and consent record is a FHIR-conformant bundle — exportable, portable and interoperable with any conformant system globally.

Clinical coding follows ICD-11, SNOMED CT, LOINC and RxNorm. Medication data aligns with the National Essential Medicines List.

HL7 FHIR R4ICD-11SNOMED CTLOINCRxNormNEML
Health Information Exchange
Your existing HIS keeps running. A FHIR adapter translates its native format into PHB-compatible bundles — no migration needed.
Exportable patient bundles
Any patient can export their full FHIR bundle at any time. Portable to any FHIR-conformant EHR worldwide.
Consent as a FHIR resource
Consent grants and revocations are modelled as FHIR Consent resources — part of the patient record, auditable and portable.
Versioned, idempotent writes
All write endpoints under /v1/ accept an Idempotency-Key. Safe to retry; guaranteed not to double-apply on network failure.
Open-source building blocks

We build in the open where we can.

phb-fhir-adapter
FHIR Adapter
Bidirectional translation layer between common Nigerian HIS formats and FHIR R4 bundles.
phb-ussd-kit
USSD Kit
Build USSD sessions with PHB's menu tree model. Tested against MTN, Airtel, Glo and 9mobile.
phb-telco-adapter
Telco & WhatsApp Adapter
Normalises telco session callbacks and WhatsApp webhook events into PHB channel events.
phb-hpn-lib
HPN Structure Library
Validate, parse and generate HPNs. Includes the Damm mod-10 check digit implementation.
phb-i18n
Multilingual Glossary
Clinical and UI terms in EN, Pidgin, Yoruba, Igbo and Hausa. Pull-request contributions welcome.
phb-consent-sdk
Consent SDK
Embed PHB consent flows in third-party apps. Handles offline consent codes and break-glass scenarios.
APIs & sandbox

Versioned REST APIs. Idempotent by design.

Every write endpoint accepts an idempotency key — safe to retry on network failure, guaranteed not to double-apply. All endpoints are versioned under /v1/.

  • Versioned endpoints under /v1/ — no breaking changes without notice
  • Idempotency keys on every write — safe to retry on network failure
  • OAuth 2.0 with provider-scoped tokens
  • Sandbox environment for testing without touching live patient data
  • Webhook events for consent changes, appointment updates and billing
GET /v1/patient/{hpn}/recordFHIR R4
// Fetch a patient bundle (consent-gated)
GET /v1/patient/PHB-4029-8156-7734/record
Authorization: Bearer <provider_token>
Idempotency-Key: <uuid>
 
// Response: FHIR Bundle (Patient + resources)
{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [ /* ... */ ]
}

Build on PHB Connect.

Request sandbox access, browse the API reference or open a support ticket with the integrations team.

Read the docs →Request API access