planCodestringrequired
Plan code (exact, case-sensitive).
Example:ANN100
policyNumberstringrequired
Policy number (exact, case-sensitive).
Example:POL123456
Transaction eligibility
Evaluates whether the authenticated user may perform specific transactions on the
given policy. Runs three checks: product level eligibility, user permissions
, and policy restrictions restrictions.
If items is omitted or empty, all transactions configured for the plan are evaluated.
partyId is extracted from the Authorization bearer token — it is never a body field.
post
Path Parameters
Body
application/json
Body
application/json
EligibilityRequest
Optional request body shared by all four eligibility endpoints. planCode and policyNumber are supplied as path parameters, not in the body.
itemsarray[string]
Subject identifiers to evaluate. Semantics depend on the endpoint: transaction/cancellation — transaction type codes (e.g. FullSurrender); capabilities — capability codes (e.g. ViewPolicy); restrictions — restriction type codes (e.g. DIVORCE, OVERPAYMENT). When absent or empty, all subjects configured for the plan are evaluated.
Example:FullSurrender, PartialWithdrawalOneTime
Response
application/json
Response
application/json
Eligibility evaluation completed. One result entry per evaluated subject.
EligibilityResponse
Top-level eligibility response envelope. Shared by all four endpoints.
eligibilityTypestringrequired
Echoes the eligibility type evaluated by the endpoint.
Allowed values:transactioncapabilitiesrestrictionscancellationsendFormDocuments
Example:transaction
resultsarray[object]required
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).
Show Child Parameters
post/policy/v2/transactions/{planCode}/{policyNumber}/eligibility/transaction
Authentication
Path Parameters
Body
{
"items": [
"FullSurrender",
"PartialWithdrawalOneTime"
]
}
application/json
Receives policyholder authorization status from MPV and updates the status
put
Path Parameters
planCodestringrequired
The plan code for the policy number
Example:planCode
policyNumberstringrequired
Policy Number
Example:policyNumber
Body
application/json
Body
application/json
Policyholder Authorization request
AuthorizationStatusRequest
recordIdstringrequired
Unique record ID (maps to transactionID)
Example:546bed32-a8b6-43dc-8772-cefb1d469b1d
correlationIdstringrequired
Correlation ID linking BPM - MPV transaction
Example:468cd184-fb43-4a20-aa8c-23df99c0a353
caseIdstringrequired
Case identifier within BPM
Example:CA0000487609
policyNumberstringrequired
Policy Number associated with the transaction
Example:FM00000001
authorizationStatusstringrequired
Policy Holder Authorization Status
Allowed values:APPROVEDDENIED
Example:APPROVED
actionTakenBystring
Name of Policy Holder
Example:Flora Anderson
actionTimestampstring(date-time)required
Generated at Time
Example:2025-06-02T10:45:00Z
sourcestring
Source system sending the callback
Default:MPV
Example:My Policy View
Response
application/json
Response
application/json
OK - Callback processed successfully
AuthorizationStatusResponse
statusinteger
Example:200
put/bpm/v1/policies/{planCode}/{policyNumber}/authorization/status
Authentication
Path Parameters
Body
{
"recordId": "546bed32-a8b6-43dc-8772-cefb1d469b1d",
"correlationId": "468cd184-fb43-4a20-aa8c-23df99c0a353",
"caseId": "CA0000487609",
"policyNumber": "FM00000001",
"authorizationStatus": "APPROVED",
"actionTimestamp": "2025-06-02T10:45:00Z"
}
application/json
Secure API to get TransactionData by transactionId
get
Path Parameters
transactionIdstringrequired
Response
application/json
Response
application/json
Transaction Model success
TransactionModelResponse
Model for a transaction with detailed information.
recordIdstring
Unique identifier for the transaction record.
correlationIdstring
Correlation ID associated with the transaction.
transactionTypestring
Type of transaction.
carrierstring
Carrier associated with the transaction.
sourcestring
Source of the transaction.
entityTypestring
Type of the entity involved.
entityIdstring
Unique identifier for the entity.
entityobject
Actual entity information as JSON Object.
expireTsstring(date-time)
Expiration timestamp for the transaction.
createdTsstring(date-time)
Timestamp when the transaction was created.
updatedTsstring(date-time)
Timestamp when the transaction was last updated.
createdBystring
User or system that created the transaction.
updatedBystring
User or system that last updated the transaction.
identifiersarray[object]
Identifier model with key-value pair.
Show Child Parameters
get/bpm/v1/policies/withdrawals/transactionstore/entities/{transactionId}
Authentication
Path Parameters
application/json
Get supported configurations for a transaction
get
Query Parameters
transactionstring
arrangementTypestring
Path Parameters
clientCodestringrequired
planCodestringrequired
transactionNamestringrequired
Allowed values:SystematicProgramSetupSystematicProgramUpdate
Response
application/json
Response
application/json
Success response
get/bpm/v1/policies/{clientCode}/{planCode}/{transactionName}/paymentforms
Authentication
Path Parameters
Query Parameters
application/json
Get supported configurations for a transaction
get
Query Parameters
transactionstring
arrangementTypestring
Path Parameters
clientCodestringrequired
planCodestringrequired
transactionNamestringrequired
Allowed values:SystematicProgramSetupSystematicProgramUpdate
Response
application/json
Response
application/json
Success response
get/bpm/v1/policies/{clientCode}/{planCode}/{transactionName}/prevalidationreference
Authentication
Path Parameters
Query Parameters
application/json