---
title: ServiceCode
summary: API reference for ServiceCode.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-24
library: SAIF.Domain
reference_type: package
---

# ServiceCode

`ServiceCode` resolves a bill or audited-service's code (procedure/revenue/service code) to its effective description for a specific date of service, implementing the date-scoped lookup behaviour of [OP-DOM-08](../../operations-processes.md#op-dom-08): it prefers a non-expired code over an expired one and then, once a code is found, picks the single `CbpServiceDescription` whose effective/expiration window covers the service date ([DOM-BR-080](../../business-rules.md#dom-br-080-code-lookup)). `BillProcedure`, `AuditedService`, and `GenerateCbpBills` all construct `ServiceCode` instances to resolve display descriptions for CBP bill and service records.

## Purpose
- Looks up a service code by code value, type, and service date, preferring a non-expired code over an expired one ([DOM-BR-080](../../business-rules.md#dom-br-080-code-lookup)).
- Resolves the single description record whose effective/expiration date range covers the service date, so `Description` always reflects wording that was current when the service occurred.
- Exposes whether the resolved code is a CPT code, which downstream billing logic uses to decide code-specific formatting/validation.

## Context
- Namespace: `SAIF.Domain.Model.Claims.Bills`
- Assembly/package: `SAIF.Domain` (packaged in `SAIF.SAIFCode.Core`)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| ServiceCode (constructor, lookup by code/type/date) | `public ServiceCode(IServiceCodeQueryProvider provider, string code, string type, DateTime serviceDate)` | Looks up the `CbpServiceCode` matching `code`/`type` as of `serviceDate` ([DOM-BR-080](../../business-rules.md#dom-br-080-code-lookup)), then resolves the date-scoped description when a code is found. |
| ServiceCode (constructor from entity) | `public ServiceCode(IServiceCodeQueryProvider provider, CbpServiceCode data, DateTime serviceDate)` | Wraps an already-loaded `CbpServiceCode` entity and resolves its date-scoped description for `serviceDate`. |
| Data | `public CbpServiceCode Data { get; }` | Exposes the underlying `CbpServiceCode` entity. |
| Code | `public string Code { get; }` | The resolved service/procedure code value. |
| CodeEffectiveDate | `public DateTime CodeEffectiveDate { get; }` | The date the resolved code became effective. |
| Description | `public string Description { get; }` | The description text whose effective/expiration window covers the constructor's service date; empty when no matching description was found. |
| DescriptionEffectiveDate | `public DateTime? DescriptionEffectiveDate { get; }` | The effective date of the resolved description record, or `null` when no description was found. |
| IsCptCode | `public bool IsCptCode { get; }` | `true` when the code appears in its service type's CPT code list. |

## Inherited public members

Members in this section are inherited from `DomainBase<TItem>` in `SAIF.Domain`. They are available on this type through inheritance (via the intermediate `DomainQueryBase<TItem,TQueryProvider>` base).

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| HasData | `public virtual bool HasData { get; }` | Reports whether the wrapped `CbpServiceCode` entity is present, evaluated as `!DataItem.IsNull()`. | `SAIF.Domain` — `DomainBase<TItem>` |

## Behavioral notes
- The date-lookup constructor resolves the description only when `HasData` is `true` after the code lookup, so a code that could not be found leaves `Description` and `DescriptionEffectiveDate` at their empty/`null` defaults.
- `GetDescription` uses `SingleOrDefault`, so more than one description row with an overlapping effective window for the same service date would throw rather than silently pick one**.

## Constraints and usage notes
- Constructing a `ServiceCode` by code/type/date issues a query-provider call in the constructor; callers should avoid constructing it repeatedly in a tight loop for the same code*.

> **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
- `Domain/SAIF.Domain/Model/Claims/Bills/ServiceCode.cs`
- `Domain/SAIF.Domain/DomainBase.cs`
- `Domain/SAIF.Domain/DomainQueryBase.cs`