---
title: "SQL-231: Retrieve Location by ID or by policy"
summary: Load Location by primary key, list all active locations for a policy, or find the policy's mailing location.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-24
library: SAIF.Services
reference_type: package
---

# SQL-231: Retrieve Location by ID or by policy

`CollectionsService` reads `Location` three ways: a primary-key load in `GetDebtorLocation`, an ordered list of non-expired locations for a policy in `GetPolicyLocations`, and a single non-expired "POL" location in `GetPolicyMailingLocation`.

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-231 |
| **Operation type** | Read |
| **Execution method** | ORM (NHibernate LINQ) |
| **Database** | Oracle |
| **Schema** | [unqualified]** |
| **Command type** | N/A (ORM-generated) |
| **Business object** | `Location` |
| **Criteria property** | N/A — ORM |
| **Lifecycle method** | `GetDebtorLocation, GetPolicyLocations, GetPolicyMailingLocation` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `:id` | Input | long | N/A | statement (1), filters LOC_SEQ_NUM by primary key |
| `:policyNum` | Input | long | N/A | statements (2)-(3), filters POLICY_NUM |

The literal `'POL'` (statement 3) is sent as a bind by NHibernate but shown inline for readability.

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| [LOCATION](../database-tables.md#location) | SELECT | LOC_SEQ_NUM, POLICY_NUM, BUS_SEQ_NUM, AGENT_NUM, PARENT_LOC_SEQ_NUM, LOC_EFF_DATE, LOC_EXP_DATE, LOCATION_CODE, LOCATION_NAME, LOC_ADDR1, LOC_ADDR2, LOC_CITY, LOC_COUNTRY, LOC_PHONE, LOC_PHONE_EXT, LOC_FAX, LOC_STATE, LOC_ZIP, LOC_ZIP4, SIC_CODE, PROVIDER_NUM, CREATE_USER, CREATE_DATE, UPDATE_USER, UPDATE_DATE, USPS_BARCODE, EMAIL_ADDR, EMPLOYEE_COUNT, LOC_ADDR3, PRIMARY_LOCATION_FLAG, CELL_PHONE, LOC_COUNTY (includes composite FK LOC_COUNTY, LOC_STATE for `County`); filters LOC_SEQ_NUM, POLICY_NUM, LOC_EXP_DATE, LOCATION_CODE |

## LINQ statement

Source: `Services/SAIF.Services/Collections/CollectionsService.cs:519`, also `:525`, `:533`.

```csharp
// Services/SAIF.Services/Collections/CollectionsService.cs:519
return UnitOfWork.GetRepository<LocationDataModel.Location>().Query()
    .SingleOrDefault(x => x.Id == id);

// Services/SAIF.Services/Collections/CollectionsService.cs:525
var locs = UnitOfWork.GetRepository<LocationDataModel.Location>()
    .Query().Where(x => x.PolicyNum == policyNum && x.ExpirationDate == null).OrderBy(x => x.AddressLine1);

// Services/SAIF.Services/Collections/CollectionsService.cs:533
var loc = UnitOfWork.GetRepository<LocationDataModel.Location>()
                    .Query().SingleOrDefault(x => x.PolicyNum == policyNum && x.ExpirationDate == null && x.LocationCode == "POL");
```

## Sample SQL

> **Inferred SQL:** This SQL was inferred from the LINQ statement above and the NHibernate mappings. It is not concrete SQL from source code; NHibernate generates the executed statement at runtime, so aliases, column order, join syntax, and bind-parameter names may differ.

```sql
-- Inferred from LINQ (NHibernate mapping translation); not concrete SQL
-- (1) L519 — GetDebtorLocation
SELECT L.LOC_SEQ_NUM,
       L.POLICY_NUM,
       L.BUS_SEQ_NUM,
       L.AGENT_NUM,
       L.PARENT_LOC_SEQ_NUM,
       L.LOC_EFF_DATE,
       L.LOC_EXP_DATE,
       L.LOCATION_CODE,
       L.LOCATION_NAME,
       L.LOC_ADDR1,
       L.LOC_ADDR2,
       L.LOC_CITY,
       L.LOC_COUNTRY,
       L.LOC_PHONE,
       L.LOC_PHONE_EXT,
       L.LOC_FAX,
       L.LOC_STATE,
       L.LOC_ZIP,
       L.LOC_ZIP4,
       L.SIC_CODE,
       L.PROVIDER_NUM,
       L.CREATE_USER,
       L.CREATE_DATE,
       L.UPDATE_USER,
       L.UPDATE_DATE,
       L.USPS_BARCODE,
       L.EMAIL_ADDR,
       L.EMPLOYEE_COUNT,
       L.LOC_ADDR3,
       L.PRIMARY_LOCATION_FLAG,
       L.CELL_PHONE,
       L.LOC_COUNTY
FROM   LOCATION L
WHERE  L.LOC_SEQ_NUM = :id

-- (2) L525 — GetPolicyLocations (deferred; executed by Mapper.Map at L528)
SELECT L.<all 32 mapped LOCATION columns, as in (1)>
FROM   LOCATION L
WHERE  L.POLICY_NUM = :policyNum
  AND  L.LOC_EXP_DATE IS NULL
ORDER BY L.LOC_ADDR1

-- (3) L533 — GetPolicyMailingLocation
SELECT L.<all 32 mapped LOCATION columns, as in (1)>
FROM   LOCATION L
WHERE  L.POLICY_NUM = :policyNum
  AND  L.LOC_EXP_DATE IS NULL
  AND  L.LOCATION_CODE = 'POL'
```

Translation notes:
- `SingleOrDefault`/`Single` add no row limit; NHibernate throws if more than one row is returned.
- `x.ExpirationDate == null` → `IS NULL`.

## Operations and processes
- CollectionsService.GetDebtorLocation — see [Operations and processes](../operations-processes.md)
- CollectionsService.GetPolicyLocations — see [Operations and processes](../operations-processes.md)
- CollectionsService.GetPolicyMailingLocation — see [Operations and processes](../operations-processes.md)

## Sources
- `Services/SAIF.Services/Collections/CollectionsService.cs (L519, L525, L533)`