postVerifyPolicyCoverage(policyId, coverageId, verifyPolicyCoverageInput)

API Version

65.0

Requires Chatter

No

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

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

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}