postVerifyPolicyCoverage(policyId, coverageId, verifyPolicyCoverageInput)

Verify the applicability of a policy coverage for a specified loss date under an insurance policy, so that only eligible coverages are processed for claims.

API Version

65.0

Requires Chatter

Signature

public static ConnectApi.VerifyPolicyCoverageRepresentation postVerifyPolicyCoverage(String policyId, String coverageId, ConnectApi.VerifyPolicyCoverageInputRepresentation verifyPolicyCoverageInput)

Parameters

policyId

Type: String
ID of the insurance policy.

coverageId

Type: String
ID of the policy coverage to verify.

verifyPolicyCoverageInput

Type: ConnectApi.VerifyPolicyCoverageInputRepresentation
JSON object that contains the loss date and other details for verification.

Return Value

Type: ConnectApi.VerifyPolicyCoverageRepresentation

Example

Use the VerifyPolicyCoverageCallable Apex class to validate whether a given insurance policy provides coverage for a specific insured asset or participant on a given loss date. This class wraps the Connect API endpoint /connect/insurance/policies/{policyId}/coverages/{coverageId}/verify. You can call this method from Apex to automate coverage verification during claim workflows.

Class Definition

1public with sharing class VerifyPolicyCoverageCallable implements System.Callable {
2
3    public Object call(String action, Map<String, Object> args) {
4        Map<String, Object> inputMap = (Map<String, Object>) args.get('input');
5        Map<String, Object> outputMap = (Map<String, Object>) args.get('output');
6
7        if (action == 'verifyPolicyCoverage') {
8            ConnectApi.VerifyPolicyCoverageInputRepresentation verificationInput =
9                (ConnectApi.VerifyPolicyCoverageInputRepresentation) inputMap.get('verificationInput');
10
11            System.debug('Start of connect API call to verify policy coverage');
12
13            ConnectApi.VerifyPolicyCoverageRepresentation verificationData;
14
15            try {
16                verificationData = ConnectApi.InsuranceClaimFamily.postVerifyPolicyCoverage(
17                    '0YTxx000000000DGAQ',   // policyId
18                    '0cYxx000000012IEAQ',   // coverageId
19                    verificationInput
20                );
21
22                System.debug('Policy coverage verification completed: ' + verificationData);
23                outputMap.put('verificationData', verificationData);
24            } catch (Exception e) {
25                System.debug('Error while verifying policy coverage: ' + e.getMessage());
26                outputMap.put('error', e.getMessage());
27            }
28
29            return verificationData;
30        }
31
32        return null;
33    }
34}

Usage Example

1VerifyPolicyCoverageCallable callable = new VerifyPolicyCoverageCallable();
2
3// Prepare input
4Map<String, Object> input = new Map<String, Object>();
5
6ConnectApi.VerifyPolicyCoverageInputRepresentation verificationInput =
7    new ConnectApi.VerifyPolicyCoverageInputRepresentation();
8
9verificationInput.lossDate = '2025-08-15';
10verificationInput.insuredAssetOrParticipantId = '0YWxx00000000P5GAI';
11
12input.put('verificationInput', verificationInput);
13
14// Prepare output and args
15Map<String, Object> output = new Map<String, Object>();
16Map<String, Object> args = new Map<String, Object>{
17    'input' => input,
18    'output' => output
19};
20
21// Call the 'verifyPolicyCoverage' action
22Object result = callable.call('verifyPolicyCoverage', args);
23
24ConnectApi.VerifyPolicyCoverageRepresentation verificationData =
25    (ConnectApi.VerifyPolicyCoverageRepresentation) result;
26
27// Log verification result
28System.debug('Policy Coverage Verification Result: ' + JSON.serializePretty(verificationData));
29
30// Check for success
31if (verificationData.isSuccess) {
32    System.debug('Policy coverage is valid for the specified loss date');
33} else {
34    System.debug('Policy coverage verification failed. Errors:');
35    for (ConnectApi.ErrorDetail error : verificationData.errors) {
36        System.debug('Error Code: ' + error.errorCode + ', Message: ' + error.message);
37    }
38}
39
40// Check for errors in the output map
41if (output.containsKey('error')) {
42    System.debug('Error: ' + output.get('error'));
43}