Search
K
Policy Transactions

EligibilitySubjectResult

object

Composed eligibility result for a single evaluated subject. Null fields are omitted from the JSON response (@JsonInclude NON_NULL). Three shapes exist: evaluated (sections present), notAvailable (subject absent from product-transactions), or notConfigured (subject absent from transactions-params).

eligibilityItemstringrequired

Subject identifier evaluated (transaction type, capability code, or restriction type code).

Example:FullSurrender

eligiblebooleanrequired

true only when policyEligibility=ELIGIBLE AND userEligibility=ELIGIBLE AND restriction is not RESTRICTED/HARD_RESTRICTED. SOFT_RESTRICTED does not fail eligibility. Any COULD_NOT_DETERMINE section forces eligible=false.

restrictedTransactionsarray[object]

A transaction affected by a restriction type, with its blocking status.

Show Child Parameters
policyEligibilityobject

One evaluation section of a per-subject result (policyEligibility, userEligibility, or restriction).
policyEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
userEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
restriction status: NOT_RESTRICTED | RESTRICTED | SOFT_RESTRICTED | HARD_RESTRICTED | COULD_NOT_DETERMINE

Show Child Parameters
userEligibilityobject

One evaluation section of a per-subject result (policyEligibility, userEligibility, or restriction).
policyEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
userEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
restriction status: NOT_RESTRICTED | RESTRICTED | SOFT_RESTRICTED | HARD_RESTRICTED | COULD_NOT_DETERMINE

Show Child Parameters
restrictionobject

One evaluation section of a per-subject result (policyEligibility, userEligibility, or restriction).
policyEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
userEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
restriction status: NOT_RESTRICTED | RESTRICTED | SOFT_RESTRICTED | HARD_RESTRICTED | COULD_NOT_DETERMINE

Show Child Parameters
notAvailableboolean

True when the subject is absent from product-transactions for this plan.

notConfiguredboolean

True when the subject has no entry in transactions-params.

messagestring

Human-readable explanation accompanying notAvailable or notConfigured.

Example:Transaction Not Configured

Example

EligibilitySectionResult

object

One evaluation section of a per-subject result (policyEligibility, userEligibility, or restriction).
policyEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
userEligibility status: ELIGIBLE | NOT_ELIGIBLE | COULD_NOT_DETERMINE
restriction status: NOT_RESTRICTED | RESTRICTED | SOFT_RESTRICTED | HARD_RESTRICTED | COULD_NOT_DETERMINE

statusstring

Allowed values:ELIGIBLENOT_ELIGIBLENOT_RESTRICTEDRESTRICTEDSOFT_RESTRICTEDHARD_RESTRICTEDCOULD_NOT_DETERMINE

Example:ELIGIBLE

blockTypestring

Blocking type from the restriction. Present on restriction section only.

Example:Unavailable

restrictionStatusarray[string]

Distinct blocking status values across all active restrictions for this subject. Present on the restriction section only when status=RESTRICTED.

Example:Unavailable, CarrierApprovalNeeded

accessarray[string]

Distinct access levels granted to the caller for this subject, derived from the permissions the caller actually holds. Present on userEligibility only when status=ELIGIBLE. The calling system decides how to act on this list.

Allowed values:VIEWWRITEDELETE

Example:VIEW, WRITE

reasonobject

Structured reason for a non-passing or indeterminate section.

Show Child Parameters
Example

EligibilityReason

object

Structured reason for a non-passing or indeterminate section.

codestring

Machine-readable reason code.

Example:INSUFFICIENT_PERMISSIONS

messagestring

Human-readable explanation.

Example:Caller does not hold the required permissions for this transaction

Example

RestrictedTransactionResult

object

A transaction affected by a restriction type, with its blocking status.

typestring

Transaction type code.

Example:FullSurrender

statusstring

How the transaction is blocked (e.g. Unavailable, CarrierApprovalNeeded).

Example:Unavailable

Example

EligibilityErrorResponse

object

Error envelope returned by eligibility endpoints on 4xx/5xx responses.

statusinteger

Example:401

errorstring

Example:Unauthorized

messagestring

Example:partyId claim could not be extracted

Example