Enrolment Intents

Create a dependents management intent for an enrolment intent

Changed on

Creates a dependents management intent as a sub-intent of an enrolment intent. The enrolment intent must be in pending_confirmation status.

post/enrolment_intents/{enrolment_intent_id}/create_dependents_management_intent

Request

  • Base URL
    https://test.api.kota.io
  • URL
    https://test.api.kota.io/enrolment_intents/{enrolment_intent_id}/create_dependents_management_intent
  • Auth
    HTTP bearer

Path parameters

enrolment_intent_idstring required
Example:ei_3b1333d87d9d4fd6ad83ba7f6b0e951a

Response

OK

idstring required

Unique identifier for the dependents management intent. Prefixed with dmi_.

objectstring

Object type identifier.

parent_intent_idstring required

The parent intent ID (e.g. Policy Amendment Intent ID). Prefixed based on type.

parent_intent_type'policy_amendment_intent' | 'enrolment_intent' required
status'action_required' | 'processing' | 'completed' | 'not_undertaken' required

Example response

{
  "id": "dmi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "dependents": [
    {
      "associated_person_id": "ap_3b1333d87d9d4fd6ad83ba7f6b0e951a",
      "coverage_selections": [
        {
          "configuration_id": "pc_3b1333d87d9d4fd6ad83ba7f6b0e951a",
          "options": [
            {
              "option_id": "pco_3b1333d87d9d4fd6ad83ba7f6b0e951a"
            }
          ]
        }
      ],
      "requirement_id": "ar_3b1333d87d9d4fd6ad83ba7f6b0e951a"
    }
  ],
  "plan": {
    "id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
    "pricing": {
      "per_member": {
        "member_type_pricing": [
          {
            "monthly_premium": 123.45
          }
        ]
      },
      "tier_based": {
        "tiers": [
          {
            "monthly_premium": 123.45,
            "annual_premium": 123.45
          }
        ]
      }
    }
  },
  "coverage_options": [
    {
      "id": "pc_3b1333d87d9d4fd6ad83ba7f6b0e951a",
      "required": true,
      "options": [
        {
          "id": "pco_3b1333d87d9d4fd6ad83ba7f6b0e951a"
        }
      ]
    }
  ],
  "action_required": {
    "due_by": "2024-12-01T00:00:00Z"
  }
}

Changes