Get a Proposal's Applicable Coverages by Domain (Extended Version)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Overview

For a specific coverage domain, returns the individual coverage options that can be added to a proposal record — along with policy configuration rules such as whether each coverage is required, common, repeatable, mutually exclusive with others, or has prerequisites. Optionally includes field-level screen metadata for building dynamic forms.

This is the extended version of GET .../Coverages/{domain}/Applicable, which returns the same coverage options with only a key, display code, and description.

This endpoint is typically used as part of a workflow:

  1. Discover available domains — GET .../Coverages/Domains
  2. List the coverage options with policy rules — this endpoint
  3. Add a coverage to the proposal — POST .../Coverages/{domain}

Examples

Scenario 1: List applicable coverages with screen metadata:

GET /api/Quotes/Proposals/12345/Coverages/ProposalCLCoverage/ApplicableEx?parentID=100&stateID=10&includeScreenMetaData=true
200 OK
[
  {
    "Key": 42,
    "DisplayCode": "BI",
    "Description": "Bodily Injury",
    "Sequence": 1,
    "IsCommon": true,
    "IsRequired": true,
    "CanRepeat": false,
    "MutuallyExclusiveIDs": [],
    "PrerequisiteIDs": [],
    "ScreenMetaData": {
      "Domain": "ProposalCLCoverage",
      "PolicyLineCode": null,
      "StateID": 10,
      "CoverageID": 42,
      "SubCoverageID": null,
      "ScreenLookupToken": "abc123",
      "Fields": [
        {
          "FieldName": "Limit",
          "DisplayName": "Coverage Limit",
          "DataType": "decimal"
        }
      ]
    }
  }
]

Scenario 2: List applicable coverages without screen metadata:

GET /api/Quotes/Proposals/12345/Coverages/ProposalCLCoverage/ApplicableEx?parentID=100
200 OK
[
  {
    "Key": 42,
    "DisplayCode": "BI",
    "Description": "Bodily Injury",
    "Sequence": 1,
    "IsCommon": true,
    "IsRequired": true,
    "CanRepeat": false,
    "MutuallyExclusiveIDs": [],
    "PrerequisiteIDs": [10]
  }
]

Scenario 3: Domain is not a coverage type:

GET /api/Quotes/Proposals/12345/Coverages/ProposalLocation/ApplicableEx
500 Internal Server Error
"Domain is not a coverage or subcoverage type: ProposalLocation"
Path Params
integer
required

The ID of the Proposal for which you are retrieving data.

string
required

The coverage domain name. Must be a domain whose type is Coverage or SubCoverage. Example: ProposalCLCoverage.

Query Params
integer

The ID of the parent record that the coverages belong to. Whether this is required depends on the domain's hierarchy: if the domain has a parent (indicated by ParentDomainName in the /Coverages/Domains response), provide the parent record's ID. If the domain has no parent, the proposal itself is the parent and this parameter is ignored.

integer

Filters the results to only include coverages applicable to the specified state. When omitted, state-based filtering is not applied.

boolean
Defaults to false

If true, the results will include screen metadata information for each coverage.

boolean
Defaults to false

If true, fields that are never applicable are ommitted from the metadata result.

string

Provide a comma-separated list of fields that can be excluded from the metadata result

Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json