API ReferenceEnrolment Intents

List all enrolment intents

Returns a list of enrolment_intents. The enrolment_intents are returned sorted by creation date, with the most recent enrolment_intent appearing first.

Authentication

AuthorizationBearer
Authorization header using the Bearer scheme

Query Parameters

employee_idstringOptionalformat: "ee_.+"
group_idstringOptionalformat: "gr_.+"
statusstringOptional

Multiple values can be provided by separating them with a comma. Allowed values are: processing, scheduled, action_required, pending_confirmation, enrolling, enrolled, not_undertaken, ineligible.

pageintegerOptional
page_sizeintegerOptional

Response

OK
idstringformat: "ei_.+"

Unique identifier for the enrolment intent. Prefixed with ei_.

employee_idstringformat: "ee_.+"

Identifier for the employee associated with this enrolment intent. Prefixed with ee_.

group_idstringformat: "gr_.+"

Identifier for the group associated with this enrolment intent. Prefixed with gr_.

statusenum
Current status of the enrolment intent.
force_confirmationboolean

If set to true, the system will always force the PendingConfirmation state before enrolling the employee, even if no action is required. This can be useful in scenarios where you want to ensure that the employee explicitly confirms their enrolment, regardless of their eligibility or any other factors. Defaults to false.

policieslist of objects or null
Policies to be created as part of this enrolment intent.
objectstring or null
The object type
ineligibility_reasonobject or null

If the enrolment intent status is ineligible, this field provides details about the reason for employees ineligibility.

policy_configurationobject or null
Policy configuration associated with this enrolment intent.
action_requiredobject or null

If the enrolment intent status is action_required, this field provides details about the action that needs to be taken to proceed with the enrolment.

pending_confirmationobject or null

If the enrolment intent status is pending_confirmation, this field provides details about the pending confirmation state.

Errors