Retrieve a dependents management intent

Retrieves a dependents_management_intent object by ID.

get/dependents_management_intents/{dependents_management_intent_id}

Path parameters

dependents_management_intent_idstring required

Example:dmi_3b1333d87d9d4fd6ad83ba7f6b0e951a

Headers

X-Platform-Idstring

The target platform id. Required only when calling with a dashboard (WorkOS AuthKit) access token instead of a platform API key — the token carries no platform claim, so the caller must say which platform it means. Ignored for platform API key / embed session token callers.

Response

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"
  }
}