Data standards

Identifiers

Pierflow IDs, identity documents, and HMO-native identifiers — what's safe to display, what to store, what to keep server-side.

Every resource has a stable Pierflow ID. External identifiers (HMO member numbers, BVN, NIN) are carried with provenance metadata so you always know where a value came from.

Pierflow IDs#

ResourcePrefixExample
Planpf_plan_pf_plan_01HX7K…
HMOpf_hmo_pf_hmo_clearline
Memberpf_mem_pf_mem_01HX7K…
Policypf_pol_pf_pol_01HX7K…
Claimpf_clm_pf_clm_01HX7K…
Providerpf_prov_pf_prov_01HX7K…
Webhook eventpf_evt_pf_evt_01HX7K…

Identity documents#

BVN (11 digits) and NIN (11 digits) are the primary identity inputs. Pierflow stores them encrypted and never returns them in full — only the last 3 digits, prefixed with asterisks.