Group Quote Intents

Create a group quote intent

Creates a group_quote_intent to request a quote for a group and plan combination, or for several (group, plan) levels of one benefit quoted together as items. The intent coordinates the quote workflow including requirements collection and quote generation.

post/group_quote_intents

Request

  • Base URL
    https://test.api.kota.io
  • URL
    https://test.api.kota.io/group_quote_intents
  • Auth
    HTTP bearer

Request body

group_idstring nullable

Unique identifier for the group to get a quote for. Required unless items is supplied.

plan_idstring nullable

Unique identifier for the plan to get a quote for. Required unless items is supplied.

expected_start_datestring date nullable

Expected start date for the insurance coverage

Example request

{
  "group_id": "gr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "cost_sharing": {
    "member_count": {
      "adults": 123,
      "children": 123
    },
    "member_selection": {
      "partner": true,
      "children": true
    },
    "member_selection_percentage_based": {
      "partner": true,
      "children": true,
      "percentage": 123
    },
    "percentage": {
      "percentage": 123
    },
    "fixed_amount": {
      "monthly_amount": 123.45
    },
    "pooled_member_count": {
      "dependents": 123
    }
  },
  "expected_start_date": "2024-12-01",
  "coverage_selections": [
    {
      "configuration_id": "pc_3b1333d87d9d4fd6ad83ba7f6b0e951a",
      "options": [
        {
          "option_id": "pco_3b1333d87d9d4fd6ad83ba7f6b0e951a"
        }
      ]
    }
  ],
  "items": [
    {
      "levels": [
        {
          "group_id": "gr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
          "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
          "cost_sharing": {
            "member_count": {
              "adults": 123,
              "children": 123
            },
            "member_selection": {
              "partner": true,
              "children": true
            },
            "member_selection_percentage_based": {
              "partner": true,
              "children": true,
              "percentage": 123
            },
            "percentage": {
              "percentage": 123
            },
            "fixed_amount": {
              "monthly_amount": 123.45
            },
            "pooled_member_count": {
              "dependents": 123
            }
          },
          "coverage_selections": [
            {
              "configuration_id": "pc_3b1333d87d9d4fd6ad83ba7f6b0e951a",
              "options": [
                {
                  "option_id": "pco_3b1333d87d9d4fd6ad83ba7f6b0e951a"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Response

OK

idstring required

Unique identifier for the group quote intent

type'single' | 'multi_level'
group_idstring nullable required

Unique identifier for the group. Null only on a multi-level intent, whose groups are on its levels.

plan_idstring nullable required

Unique identifier for the plan. Null only on a multi-level intent, whose plans are on its levels.

status'processing' | 'action_required' | 'awaiting_quote' | 'quote_available' | 'rejected' | 'rejected_by_insurer' | 'quote_expired' required
expected_start_datestring date nullable

Expected start date for the insurance coverage

objectstring

Object type identifier

Example response

{
  "id": "gqi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "group_id": "gr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "cost_sharing": {
    "member_count": {
      "adults": 123,
      "children": 123
    },
    "member_selection": {
      "partner": true,
      "children": true
    },
    "member_selection_percentage_based": {
      "partner": true,
      "children": true,
      "percentage": 123
    },
    "percentage": {
      "percentage": 123
    },
    "fixed_amount": {
      "monthly_amount": 123.45
    },
    "pooled_member_count": {
      "dependents": 123
    }
  },
  "expected_start_date": "2024-12-01",
  "items": [
    {
      "levels": [
        {
          "group_id": "gr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
          "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
          "cost_sharing": {
            "member_count": {
              "adults": 123,
              "children": 123
            },
            "member_selection": {
              "partner": true,
              "children": true
            },
            "member_selection_percentage_based": {
              "partner": true,
              "children": true,
              "percentage": 123
            },
            "percentage": {
              "percentage": 123
            },
            "fixed_amount": {
              "monthly_amount": 123.45
            },
            "pooled_member_count": {
              "dependents": 123
            }
          },
          "coverage_selections": [
            {
              "configuration_id": "pc_3b1333d87d9d4fd6ad83ba7f6b0e951a",
              "options": [
                {
                  "option_id": "pco_3b1333d87d9d4fd6ad83ba7f6b0e951a"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "action_required": {
    "due_by": "2024-12-01T00:00:00Z"
  },
  "consent_links": [
    {
      "id": "cst_3b1333d87d9d4fd6ad83ba7f6b0e951a"
    }
  ]
}

Changes