---
title: "SQL-008: Policy period retrieval"
summary: Retrieve policy periods, optionally the most recent N.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-07-31
library: SAIF.Business.View.Policy
reference_type: package
---

# SQL-008: Policy period retrieval

`clsPolicyPeriodCollection` uses this call to load a policy's periods. A caller can request every period or only the most recent N. The procedure masks risk, plan, and premium values for reduced-form periods whose information page has not yet printed.

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-008 |
| **Operation type** | Read |
| **Execution method** | Stored procedure |
| **Database** | Oracle |
| **Schema** | `[unqualified]`** |
| **Command type** | StoredProcedure |
| **Business object** | `clsPolicyPeriodCollection` |
| **Criteria property** | `RetrieveSQL` |
| **Lifecycle method** | `BeforeRetrieve` / `AfterRetrieve` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `:apolicynum` | Input | Decimal | not specified | Policy number whose periods are requested. |
| `:aTopNPolPer` | Input | Decimal | not specified | When greater than zero, limits the result to the N most recent periods; `0` retrieves all periods. |
| `recordset` | Output (Cursor) | REF CURSOR | N/A | Result set of policy periods with masked or derived risk, plan, and premium data. |

## Tables

No table is referenced directly in the .NET source. The tables read by the procedure body reside in the Oracle database and are described under [pk72846_view_policy](../procedures/pk72846_view_policy.md).

## Sample SQL

```sql
-- Stored procedure call (procedure body resides in the Oracle database - WCIS_DBA.pk72846_view_policy)
CALL pk72846_view_policy.getPolicyPeriods(
  apolicynum  => :apolicynum,
  atopnpolper => :aTopNPolPer,
  recordset   => :recordset)  -- REF CURSOR output
```

## Operations and processes

- [Retrieve supporting policy aggregates](../operations/retrieve-supporting-policy-aggregates.md)

> **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.View.Policy/clsPolicyPeriodCollection.vb`