---
title: "SQL-306: 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-306: Retrieve Subpoena

This statement retrieves ready-to-pay, certified-mail subpoenas from `SUBPOENA` (joined to `SUBPOENA_SPECIAL_HANDLING_CODE`), and a single subpoena by ID, via NHibernate LINQ over `IUnitOfWork.GetRepository<Subpoena>()`. It is executed by `SubpoenaLabelService.GenerateBatchLabels` and `SubpoenaLabelService.GetSubpoena` (`Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs (L72, L149)`) to produce certified-mail batch labels.

## Classification

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

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `:subpoenaId` | Input | Long | N/A | Subpoena identifier (`subpoenaId`) matched against `SUBPOENA_SEQ_NUM` in `GetSubpoena` |

## 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` |
| [SUBPOENA_SPECIAL_HANDLING_CODE](../database-tables.md#subpoena_special_handling_code) | JOIN (`GenerateBatchLabels` only) | `CODE`, `CLAIM_SPECIAL_HANDLING_CODE` |

## LINQ statement

Source: `Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:71`

```csharp
// Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:71-77
var approvedSubpoenas =
    _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
        .Query()
        .Where(x => x.SubpoenaStatus.Code == SubpoenaData.SubpoenaStatus.ReadyToPayCode &&
                    x.SpecialHandling.ClaimSpecialHandlingCode == "CERT")
        .OrderBy(x => x.Id)
        .ToList();

// Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs:149-151
return _unitOfWork.GetRepository<SubpoenaData.Subpoena>()
    .Query()
    .FirstOrDefault(x => x.Id == subpoenaId);
```

## 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
-- GenerateBatchLabels (L72)
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
  INNER JOIN SUBPOENA_SPECIAL_HANDLING_CODE SSHC
    ON SSHC.CODE = S.SPECIAL_HANDLING_CODE
WHERE S.SUBPOENA_STATUS_CODE = 'PAY'
  AND SSHC.CLAIM_SPECIAL_HANDLING_CODE = 'CERT'
ORDER BY S.SUBPOENA_SEQ_NUM

-- GetSubpoena (L149)
SELECT *
FROM (
  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_SEQ_NUM = :subpoenaId
)
WHERE ROWNUM <= 1
```

Translation notes:
- Constants from `Data/SAIF.Data/Model/Legal/Subpoenas/SubpoenaStatus.cs`: `ApprovedCode = "APPR"` (L6), `ReadyToPayCode = "PAY"` (L7), `PaidCode = "PAID"` (L8).
- `approvedSubpoenas.Sum(...)` (L79) runs in memory.
- `First`/`FirstOrDefault` → Oracle10 dialect row limit `SELECT * FROM (...) WHERE ROWNUM <= 1`.
- `SUBPOENA_STATUS_CODE` is not joined — `SubpoenaStatus.Code` is its identifier and short-circuits to FK `SUBPOENA.SUBPOENA_STATUS_CODE`. `SUBPOENA_SPECIAL_HANDLING_CODE` **is** joined because `ClaimSpecialHandlingCode` is a non-identifier member.
- `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
- SubpoenaLabelService.GenerateBatchLabels — see [Operations and processes](../operations-processes.md)
- SubpoenaLabelService.GetSubpoena — see [Operations and processes](../operations-processes.md)

## Sources
- `Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs (L72, L149)`