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

# IClaimDataApiClient

Contract implemented by `ClaimDataApiClient` for reading claim data, financials, conditions, contacts, MCO enrollments, vocational details, and non-converted claims from Guidewire ClaimCenter. Consumers depend on this interface so they can be constructed via dependency injection and unit-tested without a real `HttpClient`.

## Purpose
- Declares the full set of read operations for claim data available from the Guidewire ClaimDataApi, including single-claim, bulk-claim, and per-claim sub-resource lookups.

## Context
- Namespace: `SAIF.Data.Guidewire.Interfaces`
- Assembly/package: `SAIF.Data.Guidewire` (packaged in `SAIF.SAIFCode.Core`)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| GetGuidewireClaimDataMCO(long) | `Task<McoData> GetGuidewireClaimDataMCO(long claimId)` | Returns the single, current MCO for the given claim |
| GetClaim(long) | `Task<ClaimData> GetClaim(long claimId)` | Returns claim data by internal claim id |
| GetClaim(string) | `Task<ClaimData> GetClaim(string claimNumber)` | Returns claim data by claim number |
| GetClaims(List\<long\>) | `Task<ClaimsData> GetClaims(List<long> claimIds)` | Returns claim data for multiple claim ids in a single call; the implementation short-circuits to an empty result for an empty list per [SDG-BR-012](../../business-rules.md#sdg-br-012-empty-bulk-claim-request-short-circuits) |
| GetGWClaimDataCondition(long) | `Task<ClaimConditions> GetGWClaimDataCondition(long claimId)` | Returns the conditions recorded against the claim |
| GetGWClaimContacts(long) | `Task<ClaimContacts> GetGWClaimContacts(long claimId)` | Returns the contacts associated with the claim |
| GetGWClaimFinancials(long, int?, bool, bool, bool, bool) | `Task<ClaimFinancialData> GetGWClaimFinancials(long claimId, int? numberOfTransactions = null, bool excludeClaimPayments = false, bool excludeClaimReserves = false, bool excludeClaimRecoveries = false, bool excludeClaimFinancialSummary = false)` | Returns the claim's financial data, with optional exclusion flags for payments, reserves, recoveries, and the financial summary, and an optional transaction count limit |
| GetGWActiveMCOClaims(ActiveMco, bool) | `Task<ClaimMcoData> GetGWActiveMCOClaims(ActiveMco activeMco, bool claimsOnly = false)` | Returns claims associated with the active MCO enrollment described by `activeMco`; `claimsOnly` narrows the response to claims only |
| GetGWClaimVocationalDetails(long) | `Task<VocationalDetails> GetGWClaimVocationalDetails(long claimId)` | Returns vocational rehabilitation details for the claim |
| GetNonConvertedClaim(string) | `Task<NonConvertedClaim> GetNonConvertedClaim(string claimNumber)` | Returns data for a claim that has not been converted, looked up by claim number |

## Behavioral notes
- This interface carries no behavior of its own; all behavior described above belongs to the implementing class, `ClaimDataApiClient`, including caching and the empty-list short-circuit in `GetClaims`.

## Constraints and usage notes
- Two overloads of `GetClaim` exist (by `long` claim id and by `string` claim number); callers must pick the overload matching the identifier they hold.

## Sources
- `Data/SAIF.Data.Guidewire/Interfaces/IClaimDataApiClient.cs`
- `Data/SAIF.Data.Guidewire/Clients/ClaimDataApiClient.cs`