Interoperability

An introduction describing how OpenCRVS interoperates

OpenCRVS has been technically architected from conception to interoperate with other e-Gov systems in a standardised, safe and secure way.

Various APIs exist for different consumers and business use cases. The interoperability documentation is structured around theses use cases.

APIs requiring OAuth client credentials

OpenCRVS OAuth API client credentials are required in order for a trusted external system to integrate with OpenCRVS for the following use cases:

Performing a Record search of the OpenCRVS database either directly using ur GraphQL Gateway or via a DCI standard middleware.

Submitting an "Event Notification" in FHIR from healthcare systems

Subscribing to event Webhooks for status updates on a processing event

APIs for system administrators

An API exists for system administrators to perform management of OpenCRVS reference data, specifically administrative structure, civil registration offices and health facilities on a running OpenCRVS instance in production.

This is the FHIR Location API and a National System Administrators JWT is used as an authentication mechanism for these APIs.

National ID

Integrating with an external National ID system is a complex topic with multiple, optional use cases available. A dedicated section on National ID integration exists to cover:

  • Authentication and verification of informants / parents details with NID / external systems during event form completion - online / offline.

  • Generation of a National ID for a citizen at birth registration

  • Informing a National ID system that an individual is deceased at death registration

  • Specifics when selecting MOSIP as the integrating National ID system

Interoperability Roadmap

Our interoperability roadmap currently incudes:

  • Extension of the Event Notification and Webhook APIs to support a "Self-service" civil registration portal front end. Simplified payloads with and without FHIR

  • Verifiable credentials

Last updated