Industry Vocabulary Reference
Insurance: P&C, Life & Annuity
Insurance fields describe policy administration, underwriting, pricing, claims, fraud review, and reinsurance. They provide a shared vocabulary for recorded decisions and mapped policy inputs.
Back to industry coverage library
This page shows selected examples and categories. Download the JSON for the complete vocabulary, including every field, permitted value, and policy pattern in this catalog.
How to use this reference
- Start with the core file if you need the cross-industry governance baseline.
- Choose an industry file for its workflow fields and permitted values.
- Match the OTel attributes to the policy paths your rules use, then verify the recorded fields in a test session.
Catalog context
For a claims workflow, capture the claim stage and the reason for routing it to a reviewer. Keep the review outcome separate from the action the application later takes.
Risk note: Determine applicable requirements by jurisdiction, insurance line, and intended use. A recorded review or bias-test result does not establish that the process meets those requirements.
Vocabulary file
- Download filename: 03_vertical_insurance_pc_life_annuity.json
- Kind: vertical
OTel namespaces
Referenced standards
These references explain the catalog's context. A listed standard does not establish that a configured application meets its requirements.
- ACORD 2.0, P&C XML and AL3 Standards
- ACORD Life & Annuity XML (OLI/TXLife)
- ACORD GRLC Generation 2.0, Global Reinsurance & Large Commercial (April 2025)
- ACORD Next-Generation Digital Standards, JSON-based microservices API standard
- NAIC Model Bulletin: Use of Artificial Intelligence Systems by Insurers (December 2023; 24 states adopted as of March 2025)
- NAIC Model Act #880, Unfair Trade Practices Act
- NAIC Model Act #900, Unfair Claims Settlement Practices Act
- Colorado SB21-169 / Regulation 10-1-1, Governance and Risk Management for ECDIS use (effective Oct 15, 2025; expanded to auto and health)
- New York DFS Insurance Circular Letter No. 7 (July 2024), AI transparency expectations
- California Insurance Code §10123.135, Prohibition on solely automated health care decisions
- HL7 FHIR v6.0, ClaimResponse and ExplanationOfBenefit resources (health insurance claims)
- CMS Interoperability and Prior Authorization Final Rule (2024), 72-hour expedited / 7-day standard PA timelines
- NAIC Own Risk and Solvency Assessment (ORSA) Model Act #505
- Lloyd's Blueprint Two Core Data Record (CDR), built on ACORD standards
- EU Solvency II Directive, Pillar 2 model governance and internal model validation
Source references
- https://www.acord.org/standards-architecture/acord-data-standards
- https://acord.org/ACORD-about/acord-news/2025/04/10/acord-launches-grlc-generation-2.0-data-standards
- https://content.naic.org/sites/default/files/inline-files/2023-12-4%20Model%20Bulletin_Adopted_0.pdf
- https://doi.colorado.gov/for-consumers/sb21-169-protecting-consumers-from-unfair-discrimination-in-insurance-practices
- https://www.dfs.ny.gov/industry_guidance/circular_letters/cl2024_07
- https://build.fhir.org/claimresponse.html
Subdomains
| Subdomain | Categories | Sample attributes |
|---|---|---|
| Policy Lifecycle & Administration | 4 | insurance.policy.lifecycle_status, insurance.policy.transaction_type, insurance.policy.line_of_business |
| Underwriting, Rating & Pricing | 5 | insurance.underwriting.decision_status, insurance.underwriting.ai_model_type, insurance.rating.factor_category |
| Claims Intake, Triage & FNOL | 4 | insurance.claim.intake_channel, insurance.claim.status, insurance.claim.severity_tier |
| Claims Adjudication & Payment | 4 | insurance.claim.adjudication_outcome, insurance.health_claim.fhir_outcome, insurance.prior_auth.status |
| Fraud Detection & Special Investigations | 3 | insurance.fraud.indicator_type, insurance.fraud.case_status, insurance.fraud.risk_score_tier |
| Life & Annuity Underwriting | 3 | insurance.life.underwriting_method, insurance.life.mortality_rating_class, insurance.annuity.surrender_charge_status |
| Subrogation & Recoveries | 2 | insurance.subrogation.opportunity_status, insurance.subrogation.liability_basis |
| Reinsurance & Specialty Markets | 3 | insurance.reinsurance.treaty_type, insurance.reinsurance.placing_status, insurance.catastrophe.model_type |
| Regulatory Compliance & Market Conduct | 3 | insurance.ai_governance.ais_program_status, insurance.ai_governance.consumer_notice_status, insurance.ai_governance.state_regulation |
Implementation examples
- Underwriting, Rating & Pricing: Rating Factor Category. OPA rule: deny any rating action where factor_category is prohibited_characteristic_proxy or social_media_derived until Colorado Reg 10-1-1 bias test has been completed and approved. (Colorado Sb21 169: ECDIS factors require bias testing for proxy discrimination)
- Underwriting, Rating & Pricing: ECDISBias Test Outcome. OPA rule: block production deployment of any underwriting model where ecdis_bias_test_outcome is testing_not_yet_performed, material_disparity_corrective_action_pending, or model_suspended_pending_remediation. (Colorado Reg 10 1 1: Annual compliance report due Dec 1 (life); July 1, 2026 (auto and health); bias test outcomes must be documented)
- Underwriting, Rating & Pricing: Insurance AIModel Inventory Status. OPA rule: deny any agentic underwriting or claims decision where the dependent model status is not_in_inventory_shadow_model or third_party_vendor_model_pending_assessment. (Naic Model Bulletin: AIS Program must maintain inventory of all AI systems used in regulated decisions)
- Claims Intake, Triage & FNOL: Claim Severity Tier. OPA rule: route all tier_7 and above claims to human adjuster, block STP. Require HITL with senior_adjuster role for tier_8 and above. Require claims_compliance_officer for tier_10.
Control ideas
These patterns describe possible controls, not active rules. Confirm applicability, implement the control, and test its effect on the application.
Require clinical review before a medical-necessity denial
Stop a proposed medical-necessity denial when the workflow has no recorded clinician review. Keep that review with the case; the clinical determination belongs to a qualified licensed health care professional.
Regulatory basis: California Health & Safety Code §1367.01; NAIC Unfair Claims Settlement Practices Act #900; CMS Prior Authorization Final Rule (2024)
Require ecdis bias test before model deployment
Block deployment of any underwriting or rating model that uses ECDIS (External Consumer Data and Information Sources) unless the model has completed required bias testing under Colorado Regulation 10-1-1 and the NAIC Model Bulletin.
Regulatory basis: Colorado SB21-169 / Regulation 10-1-1 (effective Oct 15, 2025); NAIC Model Bulletin (24 states as of March 2025)
Enforce before the action
Pass the request and your business action to this function. The core SDK checks policy before the action runs and again before its result is released. A deny or review decision means the action never runs.
import { Veriproof } from '@veriproof/sdk-core';
import type { GovernedResult, IndustryFact, JsonValue } from '@veriproof/sdk-core';
const veriproof = Veriproof.fromEnv();
export async function runProtectedAction<TInput extends JsonValue, TValue>(
request: TInput,
action: (input: TInput, signal: AbortSignal) => Promise<TValue>,
): Promise<GovernedResult<TValue, TInput>> {
// Catalog values for this vertical. Replace them with facts from the current workflow.
const industry: IndustryFact[] = [
{ attribute: "insurance.policy.lifecycle_status", policyInput: "insurance_policy_lifecycle_status", value: "application_received" },
{ attribute: "insurance.policy.transaction_type", policyInput: "insurance_policy_transaction_type", value: "new_business" },
{ attribute: "insurance.policy.line_of_business", policyInput: "insurance_policy_line_of_business", value: "personal_auto" },
];
// Policy runs before action() and again before the result is released.
// A deny or review decision means action() never runs.
return veriproof.govern(
"insurance.pc.life.annuity.evaluate",
request,
({ input, signal }) => action(input, signal),
{ industry },
);
}- Replace the sample values with facts from the current workflow. Rules read them under
input.snapshot.industry. - Test both permitted and blocked actions. Confirm that a blocked action never reaches your business function.
- Only
completed,completed_with_warning, andtransformedresults carry a released value.
For review decisions, follow the Human Review guide to configure continuation. Observe remains available when you need to record activity without enforcing a decision.
Set up the Insurance: P&C, Life & Annuity example. See the API reference for TypeScript, Python, or .NET.
Try a simulator to see a governed decision in context. To connect your own workflow, verify your work email and start Developer free for 60 days. You can also review the relevant controls with our team.
Live demo → Start free for 60 days → Request coverage workshop →
Selected vocabulary categories
PolicyLifecycleStatus
The current lifecycle status of an insurance policy. Semantic labels align to ACORD OLI_LU_POLSTAT codes, which are captured in code_definitions for interoperability reference.
Workflow area: Policy Lifecycle & Administration
- OTel attribute
insurance.policy.lifecycle_status- First 8 permitted values
application_receivedquotedboundissuedin_forcelapsedcancelled_flatcancelled_pro_rata
PolicyTransactionType
Type of transaction being processed on a policy. Agentic policy administration agents must tag every action with this enum to enable audit trail generation and state filing compliance.
Workflow area: Policy Lifecycle & Administration
- OTel attribute
insurance.policy.transaction_type- First 8 permitted values
new_businessrenewalendorsement_add_coverageendorsement_remove_coverageendorsement_change_coverageendorsement_add_insuredendorsement_remove_insuredendorsement_address_change
InsuranceLineOfBusiness
The insurance line of business. Drives regulatory jurisdiction, form filing requirements, and applicable NAIC model acts. Also determines which state AI regulations apply (Colorado Reg 10-1-1 applies to life, auto, and health).
Workflow area: Policy Lifecycle & Administration
- OTel attribute
insurance.policy.line_of_business- First 8 permitted values
personal_autohomeownersrenterspersonal_umbrellacommercial_autocommercial_general_liabilitycommercial_propertybusinessowners_bop
PolicyCancellationReasonCode
Standardised reason codes for policy cancellation. State insurance regulations mandate specific notice periods and permissible reasons that vary by line of business. Agentic cancellation agents must validate reason code against state-specific requirements before initiating.
Workflow area: Policy Lifecycle & Administration
- OTel attribute
insurance.policy.cancellation_reason- First 8 permitted values
non_payment_of_premiummaterial_misrepresentationfraudchange_in_risk_unacceptablemoral_hazardloss_of_reinsuranceregulatory_requirementunderwriting_guideline_change
UnderwritingDecisionStatus
Defines the allowed values for Underwriting Decision Status in the Insurance: P&C, Life & Annuity catalog so OpenTelemetry spans and OPA policy inputs remain consistent across VeriProof. Terminology aligns to ACORD Underwriting Logic; NAIC Model Bulletin (Dec 2023).
Workflow area: Underwriting, Rating & Pricing
- OTel attribute
insurance.underwriting.decision_status- First 8 permitted values
accepted_standardaccepted_preferredaccepted_ratedaccepted_with_exclusionsaccepted_restricted_coverageconditional_pending_inspectionconditional_pending_medical_recordsconditional_pending_financial_records
UnderwritingAIModelType
The type of AI or predictive model used in an underwriting or rating decision. Must be declared in the AIS Program and subject to governance documentation per the NAIC Model Bulletin.
Workflow area: Underwriting, Rating & Pricing
- OTel attribute
insurance.underwriting.ai_model_type- First 8 permitted values
traditional_rule_based_enginecredit_based_insurance_scoretelematics_driving_scorepredictive_loss_modelexternal_consumer_data_ecdis_modelthird_party_vendor_modelgenerative_ai_narrativecomputer_vision_property_inspection
RatingFactorCategory
Categories of rating factors used by agentic pricing agents. Classifying each factor enables OPA rules to block use of prohibited proxy factors and enforce state filing requirements.
Workflow area: Underwriting, Rating & Pricing
- OTel attribute
insurance.rating.factor_category- First 8 permitted values
traditional_actuarial_factorcredit_based_insurance_scoretelematics_driving_behavioriot_sensor_home_monitoringgeospatial_hazard_dataaerial_imagery_propertymotor_vehicle_record_mvrclaims_history_internal
ECDISBiasTestOutcome
Outcome of the required bias and disparate impact testing for AI models using External Consumer Data and Information Sources (ECDIS). Required by Colorado Regulation 10-1-1 and NAIC Model Bulletin for life, auto, and health lines.
Workflow area: Underwriting, Rating & Pricing
- OTel attribute
insurance.underwriting.ecdis_bias_test_outcome- First 8 permitted values
testing_not_required_no_ecdis_usedtesting_not_yet_performedtesting_in_progressno_disparate_impact_detectedminor_disparity_within_tolerancematerial_disparity_corrective_action_pendingmaterial_disparity_corrective_action_completemodel_suspended_pending_remediation
InsuranceAIModelInventoryStatus
Governance status of an AI or predictive model within the insurer's AIS Program model inventory. The NAIC Model Bulletin requires all models to be documented before deployment in regulated insurance processes.
Workflow area: Underwriting, Rating & Pricing
- OTel attribute
insurance.ai_model.inventory_status- First 8 permitted values
not_in_inventory_shadow_modelregistered_in_developmentvalidated_pending_deploymentdeployed_monitoring_activedeployed_high_risk_enhanced_monitoringunder_periodic_reviewmaterial_change_pending_revalidationsuspended_pending_investigation
ClaimIntakeChannel
Defines the allowed values for Claim Intake Channel in the Insurance: P&C, Life & Annuity catalog so OpenTelemetry spans and OPA policy inputs remain consistent across VeriProof. Terminology aligns to ACORD FNOL data standards; NAIC Unfair Claims Settlement Practices Act #900.
Workflow area: Claims Intake, Triage & FNOL
- OTel attribute
insurance.claim.intake_channel- First 8 permitted values
phone_call_centermobile_app_self_serviceweb_portalai_voice_agentai_chat_agentagent_broker_submissionrepair_shop_directhospital_direct_bill
ClaimStatus
The current processing status of an insurance claim across its full lifecycle.
Workflow area: Claims Intake, Triage & FNOL
- OTel attribute
insurance.claim.status- First 8 permitted values
fnol_receivedcoverage_verification_in_progresscoverage_verifiedcoverage_denied_no_coverageinvestigation_in_progressinspection_scheduledinspection_completemedical_review_in_progress
ClaimSeverityTier
Initial severity classification assigned by AI triage agent at FNOL. Determines routing, low-severity claims eligible for straight-through processing (STP); higher tiers require human adjuster involvement.
Workflow area: Claims Intake, Triage & FNOL
- OTel attribute
insurance.claim.severity_tier- First 8 permitted values
tier_1_express_stp_eligibletier_2_low_complexitytier_3_moderate_complexitytier_4_high_complexitytier_5_large_losstier_6_catastrophetier_7_casualty_bodily_injurytier_8_litigation_suspected
This page uses the vocabulary JSON distributed with the documentation. Check its version when comparing it with an installed SDK.
Download the vocabulary JSON for offline review or automated comparisons.
Use the SDK reference for configuration and supported APIs. Keep vocabulary selection separate from the compliance team's assessment of applicable requirements.