---
title: "SQL-304: Retrieve Subpoena"
summary: Read operation against Subpoena via NHibernate ORM.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-24
library: SAIF.Services
reference_type: package
---

# SQL-304: Retrieve Subpoena

This statement retrieves ready-to-pay subpoenas from `SUBPOENA` via NHibernate LINQ over `IUnitOfWork.GetRepository<Subpoena>()`. It is executed by `OpposingCounselService.GenerateOpposingCounselDocuments` and `OpposingCounselService.UpdateSubpoenaStatus` (`Services/SAIF.Services/Legal/Subpoenas/OpposingCounselService.cs (L52, L169)`) to select all subpoenas whose status code is `PAY`, ordered by subpoena ID in the first call site, for opposing-counsel document generation and subsequent status updates.

## Classification

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

## Parameters

None (literals only or full-table read).

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| [SUBPOENA](../database-tables.md#subpoena) | SELECT | `SUBPOENA_SEQ_NUM`, `UPDATE_NUM`, `SUBPOENA_TEXT`, `SUBPOENA_OPENING_TEXT`, `SHOW_APPEARANCE_FLAG`, `ISSUE_DATE`, `REQUESTED_BY_EMPLID`, `APPROVED_DATE`, `APPROVED_BY_EMPLID`, `APPEARANCE_DATE_TIME`, `COMPLIANCE_DATE`, `BODY_PART_DESC`, `RECORDS_REQUEST_FROM_DATE`, `RECORDS_REQUEST_THRU_DATE`, `PAGE_COUNT`, `SAIF_LOCATION_FLAG`, `ADDITIONAL_CLAIM_NUMBERS`, `ADDITIONAL_CASE_NUMBERS`, `AKA_NAME`, `SERVE_BY_DATE`, `SPECIFIC_LOCATION_TEXT`, `SPECIAL_DELIVERY_TEXT`, `FILE_NUMBER`, `CREATE_USER`, `CREATE_DATE`, `UPDATE_USER`, `UPDATE_DATE`, `LEGAL_CASE_SEQ_NUM`, `SUBPOENA_STATUS_CODE`, `SUBPOENA_TYPE_CODE`, `HEARING_LOCATION_SEQ_NUM`, `SPECIAL_HANDLING_CODE`, `PROCESS_SERVER_LOC_SEQ_NUM` |

## LINQ statement

Source: `Services/SAIF.Services/Legal/Subpoenas/OpposingCounselService.cs:51`

```csharp
// Services/SAIF.Services/Legal/Subpoenas/OpposingCounselService.cs:51-56
var approvedSubpoenas =
    _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
        .Query()
        .Where(x => x.SubpoenaStatus.Code == SubpoenaData.SubpoenaStatus.ReadyToPayCode)
        .OrderBy(x => x.Id)
        .ToList();

// Services/SAIF.Services/Legal/Subpoenas/OpposingCounselService.cs:168-172
var subpoenas =
    _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
        .Query()
        .Where(x => x.SubpoenaStatus.Code == SubpoenaData.SubpoenaStatus.ReadyToPayCode)
        .ToList();
```

## 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
-- GenerateOpposingCounselDocuments (L52)
SELECT
  S.SUBPOENA_SEQ_NUM,
  S.UPDATE_NUM,
  S.SUBPOENA_TEXT,
  S.SUBPOENA_OPENING_TEXT,
  S.SHOW_APPEARANCE_FLAG,
  S.ISSUE_DATE,
  S.REQUESTED_BY_EMPLID,
  S.APPROVED_DATE,
  S.APPROVED_BY_EMPLID,
  S.APPEARANCE_DATE_TIME,
  S.COMPLIANCE_DATE,
  S.BODY_PART_DESC,
  S.RECORDS_REQUEST_FROM_DATE,
  S.RECORDS_REQUEST_THRU_DATE,
  S.PAGE_COUNT,
  S.SAIF_LOCATION_FLAG,
  S.ADDITIONAL_CLAIM_NUMBERS,
  S.ADDITIONAL_CASE_NUMBERS,
  S.AKA_NAME,
  S.SERVE_BY_DATE,
  S.SPECIFIC_LOCATION_TEXT,
  S.SPECIAL_DELIVERY_TEXT,
  S.FILE_NUMBER,
  S.CREATE_USER,
  S.CREATE_DATE,
  S.UPDATE_USER,
  S.UPDATE_DATE,
  S.LEGAL_CASE_SEQ_NUM,
  S.SUBPOENA_STATUS_CODE,
  S.SUBPOENA_TYPE_CODE,
  S.HEARING_LOCATION_SEQ_NUM,
  S.SPECIAL_HANDLING_CODE,
  S.PROCESS_SERVER_LOC_SEQ_NUM
FROM SUBPOENA S
WHERE S.SUBPOENA_STATUS_CODE = 'PAY'
ORDER BY S.SUBPOENA_SEQ_NUM

-- UpdateSubpoenaStatus (L169)
SELECT
  S.SUBPOENA_SEQ_NUM,
  S.UPDATE_NUM,
  S.SUBPOENA_TEXT,
  S.SUBPOENA_OPENING_TEXT,
  S.SHOW_APPEARANCE_FLAG,
  S.ISSUE_DATE,
  S.REQUESTED_BY_EMPLID,
  S.APPROVED_DATE,
  S.APPROVED_BY_EMPLID,
  S.APPEARANCE_DATE_TIME,
  S.COMPLIANCE_DATE,
  S.BODY_PART_DESC,
  S.RECORDS_REQUEST_FROM_DATE,
  S.RECORDS_REQUEST_THRU_DATE,
  S.PAGE_COUNT,
  S.SAIF_LOCATION_FLAG,
  S.ADDITIONAL_CLAIM_NUMBERS,
  S.ADDITIONAL_CASE_NUMBERS,
  S.AKA_NAME,
  S.SERVE_BY_DATE,
  S.SPECIFIC_LOCATION_TEXT,
  S.SPECIAL_DELIVERY_TEXT,
  S.FILE_NUMBER,
  S.CREATE_USER,
  S.CREATE_DATE,
  S.UPDATE_USER,
  S.UPDATE_DATE,
  S.LEGAL_CASE_SEQ_NUM,
  S.SUBPOENA_STATUS_CODE,
  S.SUBPOENA_TYPE_CODE,
  S.HEARING_LOCATION_SEQ_NUM,
  S.SPECIAL_HANDLING_CODE,
  S.PROCESS_SERVER_LOC_SEQ_NUM
FROM SUBPOENA S
WHERE S.SUBPOENA_STATUS_CODE = 'PAY'
```

Translation notes:
- Constants from `Data/SAIF.Data/Model/Legal/Subpoenas/SubpoenaStatus.cs`: `ApprovedCode = "APPR"` (L6), `ReadyToPayCode = "PAY"` (L7), `PaidCode = "PAID"` (L8).
- `.ToList()` materializes; `approvedSubpoenas.Any(x => x.IsProviderType())` (L58) and `subpoenas.Count()` (L173) run in memory.
- `References` (`LegalCase`, `SubpoenaStatus`, `SubpoenaType`, `HearingLocation`, `SpecialHandling`, `ProcessServerLocation`) contribute FK columns only; `HasMany(Recipients)` is lazy — `subpoena.Recipients.Any()` after materialization triggers a separate lazy collection load that is not part of this statement.

## Operations and processes
- OpposingCounselService.GenerateOpposingCounselDocuments — see [Operations and processes](../operations-processes.md)
- OpposingCounselService.UpdateSubpoenaStatus — see [Operations and processes](../operations-processes.md)

## Sources
- `Services/SAIF.Services/Legal/Subpoenas/OpposingCounselService.cs (L52, L169)`