Retrieve a dependents management intent

GET

/dependents_management_intents/:dependents_management_intent_id

GET

/dependents_management_intents/:dependents_management_intent_id

$ curl https://test.api.kota.io/dependents_management_intents/dmi_3b1333d87d9d4fd6ad83ba7f6b0e951a \
>      -H "Authorization: Bearer <token>"

1 {
2   "id": "dmi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
3   "parent_intent_id": "pai_7f8e9d6c4b2a1f0e3d4c5b6a",
4   "parent_intent_type": "policy_amendment_intent",
5   "status": "action_required",
6   "dependents": [
7     {
8       "associated_person_id": "ap_9f8e7d6c5b4a3e2d1c0b9a8f",
9       "status": "pending_confirmation",
10       "coverage_selections": null,
11       "requirement_id": null
12     }
13   ],
14   "plan": {
15     "id": "pl_4a5b6c7d8e9f0a1b2c3d4e5f",
16     "name": "Comprehensive Family Health Plan",
17     "description": "A health insurance plan covering the entire family with extensive benefits.",
18     "pricing": {
19       "type": "per_member",
20       "per_member": null,
21       "tier_based": null
22     }
23   },
24   "disclosures": [
25     {
26       "category": "regulatory",
27       "type": "intermediary_role",
28       "text": "This plan is offered through an authorized intermediary acting on behalf of the insurer."
29     }
30   ],
31   "object": "dependents_management_intent",
32   "coverage_options": null,
33   "action_required": null
34 }

Retrieves a dependents_management_intent object by ID.

Authentication

AuthorizationBearer

Authorization header using the Bearer scheme

Path parameters

dependents_management_intent_idstringRequiredformat: "dmi_.+"

Response

idstringformat: "dmi_.+"

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

parent_intent_idstring

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

parent_intent_typeenum

The type of parent intent.

statusenum

Current status of the dependents management intent.

dependentslist of objects

List of dependents being managed.

planobject

Plan information including pricing details.

disclosureslist of objects

Disclosures associated with this intent.

objectstringRead-only

Object type identifier.

coverage_optionslist of objects or null

Available member-scoped coverage options for the plan. Present when the plan has member-scoped coverage configurations.

action_requiredobject

Details of the action required from the caller. Populated only when status is action_required and a required action has been recorded on the intent (e.g. restricted dependents detected by compliance screening).

Errors

404

Not Found Error