---
title: MedicareBeneficiaryQuery
summary: API reference for MedicareBeneficiaryQuery.
status: draft
owner: SAIF.Core documentation team
last_reviewed: 2026-09-24
library: SAIF.Data
reference_type: package
---

# MedicareBeneficiaryQuery

Domain entity representing Medicare beneficiary query data within the claims medicare area of the claims/policy domain, mapped for NHibernate persistence.*

## Purpose
- Models medicare beneficiary query data used by the claims medicare area of this library.*
- Inherits shared identity/lifecycle behavior from `EntityBase`.

## Context
- Namespace: `SAIF.Data.Model.Claims.Medicare`
- Assembly/package: `SAIF.Data`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| Id | `long Id { get; set; }` | Primary key / surrogate identifier for this record.* |
| PersonId | `long PersonId { get; set; }` | Foreign-key identifier referencing the related person record.* |
| SubmissionDate | `DateTime? SubmissionDate { get; set; }` | Date/time value for submission date.* |
| MedicareClaimNumber | `string MedicareClaimNumber { get; set; }` | Value of medicare claim number exposed by this type.* |
| TaxId | `string TaxId { get; set; }` | Foreign-key identifier referencing the related tax record.* |
| LastName | `string LastName { get; set; }` | Value of last name exposed by this type.* |
| FirstInitial | `string FirstInitial { get; set; }` | Value of first initial exposed by this type.* |
| GenderCode | `string GenderCode { get; set; }` | Coded value identifying gender code.* |
| BirthDate | `DateTime? BirthDate { get; set; }` | Date/time value for birth date.* |
| IsMedicareBeneficiary | `bool IsMedicareBeneficiary { get; set; }` | Indicates whether medicare beneficiary.* |
| ResponseMedicareClaimNumber | `string ResponseMedicareClaimNumber { get; set; }` | Value of response medicare claim number exposed by this type.* |
| ResponseTaxId | `string ResponseTaxId { get; set; }` | Foreign-key identifier referencing the related response tax record.* |
| ResponseLastName | `string ResponseLastName { get; set; }` | Value of response last name exposed by this type.* |
| ResponseFirstInitial | `string ResponseFirstInitial { get; set; }` | Value of response first initial exposed by this type.* |
| ResponseGenderCode | `string ResponseGenderCode { get; set; }` | Coded value identifying response gender code.* |
| ResponseBirthDate | `DateTime? ResponseBirthDate { get; set; }` | Date/time value for response birth date.* |
| IsPrimaryTaxId | `bool IsPrimaryTaxId { get; set; }` | Foreign-key identifier referencing the related is primary tax record.* |
| UpdateUser | `string UpdateUser { get; set; }` | Value of update user exposed by this type.* |
| UpdateDate | `DateTime UpdateDate { get; set; }` | Date/time value for update date.* |
| UpdateNum | `int UpdateNum { get; set; }` | Value of update num exposed by this type.* |

## Behavioral notes
- Properties are typically declared `virtual` to support NHibernate lazy-loading proxies (see the corresponding mapping file under `Data/SAIF.Data.NHibernate`).*

## Constraints and usage notes
- No additional usage constraints beyond standard NHibernate entity/DTO conventions could be confirmed from static analysis.**

> **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
- `Data/SAIF.Data/Model/Claims/Medicare/MedicareBeneficiaryQuery.cs`