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

# RecoveryFinancialData

RecoveryFinancialData is the request payload for [FinancialDataApiClient](../SAIF.Data.Guidewire.Clients/FinancialDataApiClient.md).CreateRecoveryAsync, describing a recovery financial transaction — claim identification, cost classification, evaluation period, issue date, payee role, provider location, and the list of [RecoveryPayment](RecoveryPayment.md) line items. All properties carry explicit `JsonProperty` attributes mapping to Guidewire's camelCase JSON field names.

## Purpose
- Carries all fields required to create a recovery financial transaction against a Guidewire claim, including its constituent recovery payment line items

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

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| ClaimId | `public string ClaimId { get; set; }` | Claim id, serialized as `claimID` |
| CostCategory | `public string CostCategory { get; set; }` | Guidewire cost category code, serialized as `costCategory` |
| CostType | `public string CostType { get; set; }` | Guidewire cost type code, serialized as `costType` |
| EvaluationBeginDate | `public DateTimeOffset? EvaluationBeginDate { get; set; }` | Optional start of the recovery evaluation period, serialized as `evaluationBeginDate` and omitted when null |
| EvaluationEndDate | `public DateTimeOffset? EvaluationEndDate { get; set; }` | Optional end of the recovery evaluation period, serialized as `evaluationEndDate` and omitted when null |
| Exposure | `public string Exposure { get; set; }` | Exposure identifier the recovery applies to, serialized as `exposure` |
| InvoiceNumber | `public string InvoiceNumber { get; set; }` | Invoice number, serialized as `invoiceNumber` |
| IssueDate | `public DateTimeOffset IssueDate { get; set; }` | Date the recovery is issued, serialized as `issueDate` |
| LineItems | `public List<RecoveryPayment> LineItems { get; set; }` | Recovery payment line items, serialized as `lineItems` |
| PayeeRole | `public string PayeeRole { get; set; }` | Role of the payee, serialized as `payeeRole` |
| ProviderLocationSeqNum | `public long ProviderLocationSeqNum { get; set; }` | Provider location sequence number, serialized as `providerLocationSeqNum` |
| RecoveryCategory | `public string RecoveryCategory { get; set; }` | Recovery category code as a string, serialized as `recoveryCategory`; corresponds to the [RecoveryCategory](RecoveryCategory.md) enum values but is declared as `string` rather than the enum type* |

## Behavioral notes
- A non-success HTTP response when posting this payload via `CreateRecoveryAsync` throws with the status code and response content*.
- `EvaluationBeginDate` and `EvaluationEndDate` are only included in the serialized request when set (`NullValueHandling.Ignore`).

## Sources
- Data/SAIF.Data.Guidewire/Models/FinancialDataApi/RecoveryFinancialData.cs