--- schema_version: "1" id: 51c84021611a3d7026dd4243ecf8aebd1411e305a0563e114c7511efe54434e7 title: Claim (GET, PATCH) collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_claim.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_claim.htm source_site: developer.salesforce.com content_type: documentation content_hash: c667331d96666915c0aca1415b98c8085ab68679be177508dabdbca4143fea83 description: Get or update a claim record and its associated claim items and participants. --- # Claim (GET, PATCH) Get or update a claim record and its associated claim items and participants. ## Resource {claimId} is a placeholder. /connect/claims/{claimId} ## Resource Example Replace {yourInstance} with the My Domain name of your Salesforce org. https://{yourInstance}.salesforce.com/services/data/v68.0/connect/claims/0Zkxx000000001dEAA ## Available Version 65.0 ## HTTP Methods GET, PATCH ## Path Parameter for GET and PATCH | Parameter Name | Type | Description | Required or Optional | Available Version | | --- | --- | --- | --- | --- | | claimId | String | ID of the claim to get or update the details for. | Required | 65.0 | ## Response Body for GET [Claim Details](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_claim_output.htm "Output representation for the details of a claim record.") ## Request Body for PATCH ### JSON Example { "name": "Claim for Auto Accident", "lossDate": "2025-10-23T15:41:10.446Z", "claimLossDate": "2025-09-15", "claimType": "Auto", "claimReason": "Rear-end collision", "claimReasonType": "Accident", "lossType": "Accident", "insurancePolicyId": "0YTx0000000001qEAA", "productCode": "AutoClaimRoot", "accountId": "001xx000003DGQyAAO", "expenseReserveAmount": 750.50, "expenseReserveAdjustmentReason": "Initial expense reserve", "lossReserveAmount": 5000.00, "lossReserveAdjustmentReason": "Initial loss reserve", "additionalFields": { "PoliceReportNumber": "SF2025-00817", "IsTotalLoss": false, "ReportedDate\_\_c": "2025-09-15" }, "options": { "executeConfigurationRules": "false" }, "attributes": { "list": \[ { "apiName": "WeatherConditions", "value": "Clear and Sunny" }, { "apiName": "NumberOfVehicles", "value": "2" } \] }, "items": { "list": \[ { "instanceKey": "item\_vehicle\_damage\_01", "name": "Damaged Rear Bumper and Trunk", "productCode": "AUTO-SEDAN-2023", "category": "Auto Physical Damage", "insuredItemId": "02ixx0000004l5sAAA", "insurancePolicyCoverageId": "0cvxx000000AbCdEfG", "attributes": { "list": \[ { "apiName": "DamageSeverity", "value": "Moderate" } \] }, "additionalFields": { "RepairEstimate": 2750, "Date\_Damage\_First\_Noticed\_\_c": "2025-09-15" }, "relatedObjects": { "list": \[ { "relatedRecordId": "001xx000003DGQzAAP", "relatedRecordObjName": "Account" } \] }, "participantInstanceKey": "participant\_driver\_01", "action": "update" } \] }, "participants": { "list": \[ { "instanceKey": "participant\_driver\_01", "contactId": "003xx000003DGQyAAO", "accountId": "001xx000003DGQyAAO", "insurancePolicyParticipantId": "0pPxx000000001qEAA", "isInjured": false, "roles": \[ "Driver", "Claimant" \], "additionalFields": { "StatementTaken": true }, "action": "update" } \] } } ### Properties
Name Type Description Required or Optional Available Version
accountId String ID of the account that's associated with the claim. Optional 65.0
additionalFields Object Additional standard or custom fields that are used to create or update insurance claim. Optional 65.0
attributes Claim Attribute Input[] Attributes of the claim product. Optional 65.0
claimLossDate String Date when the loss occurred.

This parameter doesn't accept time of incident. To specify both the date and time of loss, use the lossDate parameter.

Optional 66.0
claimReason String Reason for the claim. Optional 65.0
claimReasonType String Category that the claim reason belongs to. Optional 65.0
claimType String Type of claim. Optional 65.0
expenseReserve​AdjustmentReason String Reason for the expense reserve adjustment. Optional 68.0
expenseReserve​Amount Double Amount that's reserved to cover potential expenses while handling the claim, such as administrative or legal costs. Optional 68.0
insurance​PolicyId String ID of the insurance policy on which the claim is raised. Optional 65.0
items Claim Item Input[] Details of the items that are associated with the claim. Optional 65.0
lossDate Date Date and time when the loss occurred.

You must specify both the date and time of the incident; otherwise, the API returns an error. To specify only the date of loss, use the claimLossDate parameter.

Optional 65.0
lossReserve​AdjustmentReason String Reason for the loss reserve adjustment. Optional 68.0
lossReserveAmount Double Amount that's reserved to cover a potential payment for a loss. Optional 68.0
lossType String Type of the loss for which the claim is initiated. Optional 65.0
name String Name of the claim. Optional 65.0
options Claim Options Input Options for creating or updating a claim. Optional 65.0
participants Claim Participant Input[] Claim participants that are associated with the claim. Optional 65.0
productCode String Product code of the claim product. Required to create a claim 65.0
## Response Body for PATCH [Claim Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_create_claim_output.htm "Output representation for a created or updated claim.")