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

This statement retrieves subpoenas that are neither paid nor ready-to-pay from `SUBPOENA` (inbox items), and a single subpoena by ID, via NHibernate LINQ over `IUnitOfWork.GetRepository<Subpoena>()`. It is executed by `SubpoenaService.GetInboxItems` and `SubpoenaService.GetSubpoena` (`Services/SAIF.Services/Legal/Subpoenas/SubpoenaService.cs (L95, L220)`).

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-309 |
| **Operation type** | Read |
| **Execution method** | ORM (NHibernate LINQ) |
| **Database** | Oracle |
| **Schema** | [unqualified]** |
| **Command type** | N/A (ORM-generated) |
| **Business object** | `SubpoenaService` |
| **Criteria property** | N/A — ORM |
| **Lifecycle method** | `GetInboxItems, 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` |

## LINQ statement

Source: `Services/SAIF.Services/Legal/Subpoenas/SubpoenaService.cs:94`

```csharp
// Services/SAIF.Services/Legal/Subpoenas/SubpoenaService.cs:94-101
var subpoenas =
    (_unitOfWork.GetRepository<Data.Model.Legal.Subpoenas.Subpoena>()
        .Query()
        .Where(
            x =>
                x.SubpoenaStatus.Code != LegalData.Subpoenas.SubpoenaStatus.PaidCode &&
                x.SubpoenaStatus.Code != LegalData.Subpoenas.SubpoenaStatus.ReadyToPayCode)
        .ToList());

// Services/SAIF.Services/Legal/Subpoenas/SubpoenaService.cs:220-222
LegalData.Subpoenas.Subpoena subpoenaFromDataBase = _unitOfWork.GetRepository<LegalData.Subpoenas.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
-- GetInboxItems (L95)
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 <> 'PAID'
  AND S.SUBPOENA_STATUS_CODE <> 'PAY'

-- GetSubpoena (L220)
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).
- Rows with a NULL `SUBPOENA_STATUS_CODE` are excluded by `<>` (UNKNOWN) in SQL.
- `First`/`FirstOrDefault` → Oracle10 dialect row limit `SELECT * FROM (...) WHERE ROWNUM <= 1`.
- `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
- SubpoenaService.GetInboxItems — see [Operations and processes](../operations-processes.md)
- SubpoenaService.GetSubpoena — see [Operations and processes](../operations-processes.md)

## Sources
- `Services/SAIF.Services/Legal/Subpoenas/SubpoenaService.cs (L95, L220)`