Skip to Content

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.

v2026.03.1631 enum categories2.2 schema9 subdomains15 standards

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.

Download vocabulary JSONOpen industry SDK quickstartStart free for 60 days 

How to use this reference

  1. Start with the core file if you need the cross-industry governance baseline.
  2. Choose an industry file for its workflow fields and permitted values.
  3. 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

insurance

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

Subdomains

SubdomainCategoriesSample attributes
Policy Lifecycle & Administration4insurance.policy.lifecycle_status, insurance.policy.transaction_type, insurance.policy.line_of_business
Underwriting, Rating & Pricing5insurance.underwriting.decision_status, insurance.underwriting.ai_model_type, insurance.rating.factor_category
Claims Intake, Triage & FNOL4insurance.claim.intake_channel, insurance.claim.status, insurance.claim.severity_tier
Claims Adjudication & Payment4insurance.claim.adjudication_outcome, insurance.health_claim.fhir_outcome, insurance.prior_auth.status
Fraud Detection & Special Investigations3insurance.fraud.indicator_type, insurance.fraud.case_status, insurance.fraud.risk_score_tier
Life & Annuity Underwriting3insurance.life.underwriting_method, insurance.life.mortality_rating_class, insurance.annuity.surrender_charge_status
Subrogation & Recoveries2insurance.subrogation.opportunity_status, insurance.subrogation.liability_basis
Reinsurance & Specialty Markets3insurance.reinsurance.treaty_type, insurance.reinsurance.placing_status, insurance.catastrophe.model_type
Regulatory Compliance & Market Conduct3insurance.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, and transformed results 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.

Start your Developer evaluation

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_received
  • quoted
  • bound
  • issued
  • in_force
  • lapsed
  • cancelled_flat
  • cancelled_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_business
  • renewal
  • endorsement_add_coverage
  • endorsement_remove_coverage
  • endorsement_change_coverage
  • endorsement_add_insured
  • endorsement_remove_insured
  • endorsement_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_auto
  • homeowners
  • renters
  • personal_umbrella
  • commercial_auto
  • commercial_general_liability
  • commercial_property
  • businessowners_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_premium
  • material_misrepresentation
  • fraud
  • change_in_risk_unacceptable
  • moral_hazard
  • loss_of_reinsurance
  • regulatory_requirement
  • underwriting_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_standard
  • accepted_preferred
  • accepted_rated
  • accepted_with_exclusions
  • accepted_restricted_coverage
  • conditional_pending_inspection
  • conditional_pending_medical_records
  • conditional_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_engine
  • credit_based_insurance_score
  • telematics_driving_score
  • predictive_loss_model
  • external_consumer_data_ecdis_model
  • third_party_vendor_model
  • generative_ai_narrative
  • computer_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_factor
  • credit_based_insurance_score
  • telematics_driving_behavior
  • iot_sensor_home_monitoring
  • geospatial_hazard_data
  • aerial_imagery_property
  • motor_vehicle_record_mvr
  • claims_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_used
  • testing_not_yet_performed
  • testing_in_progress
  • no_disparate_impact_detected
  • minor_disparity_within_tolerance
  • material_disparity_corrective_action_pending
  • material_disparity_corrective_action_complete
  • model_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_model
  • registered_in_development
  • validated_pending_deployment
  • deployed_monitoring_active
  • deployed_high_risk_enhanced_monitoring
  • under_periodic_review
  • material_change_pending_revalidation
  • suspended_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_center
  • mobile_app_self_service
  • web_portal
  • ai_voice_agent
  • ai_chat_agent
  • agent_broker_submission
  • repair_shop_direct
  • hospital_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_received
  • coverage_verification_in_progress
  • coverage_verified
  • coverage_denied_no_coverage
  • investigation_in_progress
  • inspection_scheduled
  • inspection_complete
  • medical_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_eligible
  • tier_2_low_complexity
  • tier_3_moderate_complexity
  • tier_4_high_complexity
  • tier_5_large_loss
  • tier_6_catastrophe
  • tier_7_casualty_bodily_injury
  • tier_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.

Last updated on