Group Quote Intents

Retrieve a group quote intent

Changed on

Retrieves a group_quote_intent object.

get/group_quote_intents/{group_quote_intent_id}

Request

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

Path parameters

group_quote_intent_idstring required
Example:gqi_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

  • 998f7cb004abRevision changes
    • warning

      deleted the header request parameter X-Platform-Id

  • ce9736d28f93Revision changes
    • warning

      added the new pooled_member_count enum value to the ///////// response property for the response status

    • warning

      added the new pooled_member_count enum value to the ///////////// response property for the response status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///////// to the response with the status