API ReferencePolicy Import Intents

Create a new policy import intent

Initiates a policy import process for an employee with an existing policy created outside of Kota's systems. This endpoint allows importing policy details for an employee who has an existing policy with one of our existing providers.

Authentication

AuthorizationBearer
Authorization header using the Bearer scheme

Request

This endpoint expects an object.
employee_idstringRequiredformat: "ee_.+"

The employee ID for the policy import. Prefixed with ee_.

group_idstringRequiredformat: "gr_.+"

The group ID for the policy import. Prefixed with g_.

provider_policy_numberstringRequired
The provider's policy number.
member_numberstringRequired
The member number assigned by the provider.
policy_start_datedateRequired
The start date of the policy.
policy_end_datedate or nullOptional
The end date of the policy. Leave null if the policy has no end date.
associated_personslist of objects or nullOptional
List of associated persons to be linked to this policy import.

Response

OK
idstringformat: "pii_.+"

Unique identifier for the policy import intent. Prefixed with pii_.

statusenum
Current status of the policy import intent.
Allowed values:
employee_idstringformat: "ee_.+"

The employee ID for the policy import. Prefixed with ee_.

group_idstringformat: "gr_.+"

The group ID for the policy import. Prefixed with g_.

provider_policy_numberstring
The provider's policy number.
member_numberstring
The member number assigned by the provider.
policy_start_datedate
The start date of the policy.
associated_personslist of objects
List of associated persons linked to this policy import.
objectstring or nullRead-only
Object type identifier.
policy_end_datedate or null
The end date of the policy. Null if the policy has no end date, or end date is not known.

Errors