---
title: IPolicyHeaderAssociation
summary: API reference for IPolicyHeaderAssociation.
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy
reference_type: package
---

# IPolicyHeaderAssociation

`IPolicyHeaderAssociation` extends `IPolicyAssociation` with the additional display fields needed to present an associated policy in the policy-header UI: the associated policy's name, agent, agency sequence number, status description, and period effective/expiration dates. `IPolicyHeaderDataProvider.PolicyAssociations` returns a collection of these records.

## Purpose
- Extend the base `IPolicyAssociation` contract with human-readable, display-ready fields for the associated policy.
- Supply the period effective/expiration dates so the header UI can show the current validity window of the associated policy.

## Context
- Namespace: `SAIF.Business.Policy`
- Assembly/package: `SAIF.Business.Policy`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `PolicyName` | `ReadOnly Property PolicyName As String` | The display name of the associated policy. |
| `AgentNumber` | `ReadOnly Property AgentNumber As Decimal` | The agent number associated with the related policy. |
| `AgencySeqNum` | `ReadOnly Property AgencySeqNum As Decimal` | The agency sequence number associated with the related policy. |
| `PolicyStatusDescription` | `ReadOnly Property PolicyStatusDescription As String` | A human-readable description of the related policy's status. |
| `PeriodEffectiveDate` | `ReadOnly Property PeriodEffectiveDate As Date` | The effective date of the related policy's current period. |
| `PeriodExpirationDate` | `ReadOnly Property PeriodExpirationDate As Date` | The expiration date of the related policy's current period. |

## Inherited public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `PolicyNumber` | `ReadOnly Property PolicyNumber As Decimal` | Inherited from `IPolicyAssociation`; the policy number of the related policy. |
| `IsParent` | `ReadOnly Property IsParent As Boolean` | Inherited from `IPolicyAssociation`; indicates whether this record is the parent side of the relationship. |
| `AssociationType` | `ReadOnly Property AssociationType As IPolicyAssociationType` | Inherited from `IPolicyAssociation`; the type of association linking the two policies. |
| `Equals` | `Function Equals(ByVal inAssociation As IPolicyAssociation) As Boolean` | Inherited from `IPolicyAssociation`; the concrete implementation in `clsPolicyAssociation` (`SAIF.Business.View.Policy`) considers two associations equal when their `AssociationType`, `PolicyNumber`, and `IsParent` all match — the interface itself does not mandate this.* |


## Behavioral notes
- Source declaration: `Business\SAIF.Business.Policy\IPolicyHeaderDataProvider.vb`.
- Related operations, rules, and SQL are cross-referenced from the library-level documentation.

## Constraints and usage notes
- Consumers should rely on the declared public surface rather than internal implementation details.

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- `Business\SAIF.Business.Policy\IPolicyHeaderDataProvider.vb`