Get Census Price Comparison Action

Calculate price comparison impacts for group census members based on their plan enrollments. This action calculates the financial comparison of changes to a group census by comparing the previous and current costs across plans, group classes, members, and coverages, returning a breakdown of total cost, premium, tax, and fees to help evaluate the comparison of proposed changes.

This action is available in API version 68.0 and later.

Supported REST HTTP Methods

URI: /services/data/v68.0/actions/standard/getCensusPriceComparison

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer token

Inputs

Input Type Description
censusId string Required. ID of the group census record to calculate price comparisons for.
insurancePriceComparisonInput Apex-defined An Apex ConnectApi.InsurancePriceComparisonInputRepresentation record that contains the optional filters, such as member IDs, category, and fetch attribute flag to calculate price comparisons.

Outputs

Output Type Description
priceComparisonOutput Apex-defined An Apex ConnectApi.RateComparisonOutputRepresentation record that contains the hierarchical price comparison results.

Example

POST

This sample request is for the Get Census Price Comparison action.

1{
2  "inputs": [
3    {
4      "censusId": "0rfxx000000001aEAA",
5      "insurancePriceComparisonInput": {
6        "category": "vision",
7        "fetchAttributes": true,
8        "memberIds": [
9          "0rgxx000000001aEAA",
10          "0rgxx000000002bEAA"
11        ]
12      }
13    }
14  ]
15}

This sample response is for the Get Census Price Comparison action.

1[
2  {
3    "actionName": "getCensusPriceComparison",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outcome": null,
8    "outputValues": {
9      "priceComparisonOutput": {
10        "categories": {
11          "dental": "Dental",
12          "vision": "Vision"
13        },
14        "comparisons": [
15          {
16            "category": null,
17            "current": {
18              "attributes": [],
19              "fee": 400,
20              "id": "0rHxx000000001aEAA",
21              "premium": 2000,
22              "tax": 180,
23              "total": 2580
24            },
25            "durationKey": "dur1",
26            "id": "identifier1",
27            "name": null,
28            "node": "summary",
29            "parent": null,
30            "previous": {
31              "attributes": [],
32              "fee": 200,
33              "id": "0rHxx000000002bEAA",
34              "premium": 1800,
35              "tax": 180,
36              "total": 2180
37            }
38          }
39        ],
40        "currencyInfo": {
41          "locale": "en_US",
42          "name": "USD",
43          "symbol": "$"
44        },
45        "durations": [
46          {
47            "effectiveFrom": "2026-01-01",
48            "effectiveTo": "2026-12-31",
49            "key": "dur1"
50          }
51        ],
52        "errors": [],
53        "isSuccess": true,
54        "summary": {
55          "endorse": 10,
56          "enrollment": 0,
57          "hire": 20,
58          "terminate": 10
59        }
60      }
61    },
62    "sortOrder": -1,
63    "version": 1
64  }
65]