NPHCDA Immunization FHIR IG
0.7.0 - ci-build Nigeria flag

NPHCDA Immunization FHIR IG, published by https://nphcda.gov.ng. This guide is not an authorized publication; it is the continuous build for version 0.7.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Nigeria-FHIR-Community/NPHCDA-ImmunizationIG/ and changes regularly. See the Directory of published versions

CapabilityStatement: NG-Imm Server CapabilityStatement

Official URL: http://nphcda.gov.ng/ig/immunization/CapabilityStatement/NgImmCapabilityStatementServer Version: 0.7.0
Active as of 2025-08-07 Computable Name:

This CapabilityStatement describes the expected behaviour of an Immunization server managed by NPHCDA that other Immunization clients or server connect to or share information for care fulfillment.

Raw OpenAPI-Swagger Definition file | Download

NG-Imm Server CapabilityStatement

  • Implementation Guide Version: 0.7.0
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2025-08-07
  • Published by: https://nphcda.gov.ng

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

The server system (Registry) allow interaction by clients systems via standard RESTful interactions and some custom operations.

Use of HTTP Methods:

  • POST: Used to create a new resource. A client server assigns resource ID before submitting to this server. This server will generate unique resource id based off the client resource id.
  • PUT: Not supported on this server.
  • PATCH: Used for partial updates.

Resource ID Management:

The client server auto-generates id during POST to local client. When syncing to this server, client systems must use server-assigned ID for PATCH operations.

Provenance:

Provenance is required for all operations and must contain:

  • target: Resource reference
  • agent: Responsible person or system (Practitioner or Organization)
  • recorded: Timestamp
  • who: Responsible submitting actor

Bundles:

  • NgImmClientRegistrationBundle – Register a client (Patient, Practitioner, Encounter, Org, Obs, RelatedPerson, Provenance).
  • NgImmRegisterFacilityBundle – Register facilities with Organization, Location, Practitioner, PractitionerRole.
  • NgImmUpdateClientBundle – Update client details (Encounter, Observation, Immunization, Practitioner, Organization).
  • NgImmManageReportAEFIBundle – Submit/manage AEFI reports (Encounter, Observation, AllergyIntolerance).
  • NgImmGenerateReportBundle – Exchange of aggregate data using Measure, MeasureReport, Organization, Practitioner.

Supported Data Exchange:

  • Synchronization using bundles
  • Registration and update of patients and immunizations
  • Lookup and display of vaccinations and schedules

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRV-RSUPCH-IH-TSearches_include_revincludeOperations
Patienthttp://nphcda.gov.ng/ig/immunization/StructureDefinition/NgImmPatientyyyypseudo-id, birthdate, createddate, genderNgImmProvenance:target
Immunizationhttp://nphcda.gov.ng/ig/immunization/StructureDefinition/NgImmImmunizationyyyyypatient-pseudo-id, status, vaccine-code, dateNgImmProvenance:target$submit-ngimm-immunization
Bundlehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ngimm-client-registration-bundleyyyyyyyypatient.identifier, _lastUpdated, vaccine-code, organization-identifierNgImmProvenance:target$submit-ngimm-bundle
Organizationhttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ng-imm-organizationyyyyyyyorganization-identifierNgImmProvenance:target$submit-ngimm-organization
Encounterhttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ng-imm-encounteryyyyyyyencounter-identifierNgImmProvenance:target$submit-ngimm-encounter
RelatedPersonhttp://nphcda.gov.ng/ig/immunization/StructureDefinition/mother-other-childrenyyyyyyysibling-pseudo-idNgImmProvenance:target$submit-ngimm-relatedperson
Practitionerhttp://nphcda.gov.ng/ig/immunization/StructureDefinition/NgImmPractitioneryyyyyyypractitioner-pseudo-id, licenseNgImmProvenance:target$submit-ngimm-practitioner
MeasureReporthttp://nphcda.gov.ng/ig/immunization/StructureDefinition/measure-report-profileyyyyyyymeasurereport-identifierNgImmProvenance:target$submit-ngimm-measurereport
Provenancehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ng-imm-provenanceyyyyyyyprovenance-identifierNgImmProvenance:target
StructureMaphttp://hl7.org/fhir/StructureDefinition/StructureDefinitionNgImmProvenance:target$transform
Bundlehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ngimm-register-facility-bundleyyyyyyyypatient.identifier, _lastUpdated, vaccine-code, organization-identifierNgImmProvenance:target$submit-ngimm-bundle
Bundlehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ngimm-update-client-bundleyyyyyyyypatient.identifier, _lastUpdated, vaccine-code, organization-identifierNgImmProvenance:target$submit-ngimm-bundle
Bundlehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ngimm-manage-report-aefi-bundleyyyyyyyypatient.identifier, _lastUpdated, vaccine-code, organization-identifierNgImmProvenance:target$submit-ngimm-bundle
Bundlehttp://nphcda.gov.ng/ig/immunization/StructureDefinition/ngimm-generate-report-bundleyyyyyyyypatient.identifier, _lastUpdated, vaccine-code, organization-identifierNgImmProvenance:target$submit-ngimm-bundle

Resource Conformance: supported Patient

Base System Profile
NG-Imm Patient
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, history-type, search-type.

Documentation

Full support for NgImmPatient including get and detailed search parameters referencing DAK and NIS ISO set of standards.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpseudo-idtoken

Search a particular patient using their Pseudonym identifier as per NIS ISO 25237:2019

SHALLbirthdatedate

Filter patients by date of birth. Format: YYYY-MM-DD.

SHALLcreateddatedate

Filter patients by date of record creation. Format: YYYY-MM-DD.

SHALLgendertoken

Filter patients by sex (Male, Female). Bound to NGGenderVS.

 

Resource Conformance: supported Immunization

Base System Profile
NG-Imm Immunization
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-type, search-type.

Documentation

Full support for NgImmImmunization including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatient-pseudo-idreference
SHALLstatustoken
SHALLvaccine-codetoken
SHALLdatedate
 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-immunization

Submits an instance of NgImmImmunization profile to the national immunization registry/repository.

Resource Conformance: supported Bundle

Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, update, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmBundle including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatient.identifiertoken
SHALL_lastUpdateddate
SHALLvaccine-codetoken
SHALLorganization-identifiertoken
 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-bundle

Submits an instance of bundle profile to the national immunization registry/repository.

Resource Conformance: supported Organization

Base System Profile
NG-Imm Organization
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmOrganization profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLorganization-identifiertoken
 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-organization

Submits an instance of NgImmOrganiztion profile to the national immunization registry/repository.

Resource Conformance: supported Encounter

Base System Profile
NG-Imm Encounter
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmEncounter profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLencounter-identifiertoken
 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-encounter

Submits an instance of NgImmEncounter profile to the national immunization registry/repository.

Resource Conformance: supported RelatedPerson

Base System Profile
NG-Imm RelatedPerson
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmSiblingRelatedPerson profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLsibling-pseudo-idtoken

Search a particular related person. Use steps referenced in Standard Organization of Nigeria (SON's) NIS ISO 25237:2019 for detailed steps

 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-relatedperson

Submits an instance of NgImmRelatedPerson profile to the national immunization registry/repository.

Resource Conformance: supported Practitioner

Base System Profile
NG-Imm Practitioner
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmPractitioner profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpractitioner-pseudo-idtoken

Search a particular Practitioner. Use steps referenced in Standard Organization of Nigeria (SON's) NIS ISO 25237:2019 for detailed steps

SHALLlicensetoken

Search a practtioner by ther public facing MDCN, Pharmacy, or related licenses

 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-practitioner

Submits an instance of NgImmPractiioner profile to the national immunization registry/repository.

Resource Conformance: supported MeasureReport

Base System Profile
NG-Imm MeasureReport
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmMeasureReport profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLmeasurereport-identifiertoken
 
Extended Operations
ConformanceOperationDocumentation
SHALL$submit-ngimm-measurereport

Submits an instance of NgImmMeasureReport profile to the national immunization registry/repository.

Resource Conformance: supported Provenance

Base System Profile
NG-Imm Provenance
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, vread, patch, history-instance, history-type, create, search-type.

Documentation

Full support for NgImmProvenance profile including detailed search parameters.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLprovenance-identifiertoken
 

Resource Conformance: supported StructureMap

Base System Profile
StructureDefinition
Profile Conformance
SHALL
Reference Policy

Interaction summary

    Extended Operations
    ConformanceOperationDocumentation
    SHALL$transform

    The Server can recieve the register patient logical model structured data and transform them into an insance of NgImmPatient FHIR profile

    Resource Conformance: supported Bundle

    Profile Conformance
    SHALL
    Reference Policy

    Interaction summary
    • Supports read, vread, update, patch, history-instance, history-type, create, search-type.

    Documentation

    Full support for NgImmBundle including detailed search parameters.

    Search Parameters
    ConformanceParameterTypeDocumentation
    SHALLpatient.identifiertoken
    SHALL_lastUpdateddate
    SHALLvaccine-codetoken
    SHALLorganization-identifiertoken
     
    Extended Operations
    ConformanceOperationDocumentation
    SHALL$submit-ngimm-bundle

    Submits an instance of bundle profile to the national immunization registry/repository.

    Resource Conformance: supported Bundle

    Base System Profile
    IMMZ.C6 Bundle Update Client
    Profile Conformance
    SHALL
    Reference Policy

    Interaction summary
    • Supports read, vread, update, patch, history-instance, history-type, create, search-type.

    Documentation

    Full support for NgImmBundle including detailed search parameters.

    Search Parameters
    ConformanceParameterTypeDocumentation
    SHALLpatient.identifiertoken
    SHALL_lastUpdateddate
    SHALLvaccine-codetoken
    SHALLorganization-identifiertoken
     
    Extended Operations
    ConformanceOperationDocumentation
    SHALL$submit-ngimm-bundle

    Submits an instance of bundle profile to the national immunization registry/repository.

    Resource Conformance: supported Bundle

    Profile Conformance
    SHALL
    Reference Policy

    Interaction summary
    • Supports read, vread, update, patch, history-instance, history-type, create, search-type.

    Documentation

    Full support for NgImmBundle including detailed search parameters.

    Search Parameters
    ConformanceParameterTypeDocumentation
    SHALLpatient.identifiertoken
    SHALL_lastUpdateddate
    SHALLvaccine-codetoken
    SHALLorganization-identifiertoken
     
    Extended Operations
    ConformanceOperationDocumentation
    SHALL$submit-ngimm-bundle

    Submits an instance of bundle profile to the national immunization registry/repository.

    Resource Conformance: supported Bundle

    Base System Profile
    IMMZ.H Bundle GenerateReport
    Profile Conformance
    SHALL
    Reference Policy

    Interaction summary
    • Supports read, vread, update, patch, history-instance, history-type, create, search-type.

    Documentation

    Full support for NgImmBundle including detailed search parameters.

    Search Parameters
    ConformanceParameterTypeDocumentation
    SHALLpatient.identifiertoken
    SHALL_lastUpdateddate
    SHALLvaccine-codetoken
    SHALLorganization-identifiertoken
     
    Extended Operations
    ConformanceOperationDocumentation
    SHALL$submit-ngimm-bundle

    Submits an instance of bundle profile to the national immunization registry/repository.