Sign in
Legal Entity Change Events

Get legal entity change event by ID

Returns a single legal entity change event including JSONB diff and snapshot.

get/api/legal-entity-change-events/{id}

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/legal-entity-change-events/{id}
  • Auth: none required

Path parameters

idstring uuid required

Legal entity change event ID

Response

Legal entity change event

account_holder_idstring uuid nullable

AccountHolder context link (nullable — event may affect both threads)

acmt_confirmation_idstring nullable

acmt:002 MsgId — confirmation message reference, populated once confirmed

acmt_instruction_idstring nullable

acmt:006 MsgId — upsert deduplication key. Unique per tenant when set (sparse unique index)

beneficial_owner_idstring uuid nullable

BeneficialOwner context link (nullable — event may affect both threads)

change_channel'web' | 'mobile' | 'branch' | 'api' | 'phone_banking' required

Channel through which the modification request was received

changesobject nullable

JSONB diff of changed fields: keys are field names, values are [previous_value, new_value]. System-generated from Ecto changeset on update_legal_entity — not user-supplied.

event_status'pending' | 'confirmed' | 'rejected' | 'recorded' nullable

Lifecycle status — pending (change requested), confirmed (verified and applied), rejected (denied by compliance / KYC check), recorded (automatically set by DB trigger for system-generated events)

event_type'address_change' | 'phone_change' | 'email_change' | 'beneficiary_added' | 'beneficiary_removed' | 'beneficiary_modified' | 'account_inquiry' | 'contact_info_change' | 'authorised_signer_change' required

Type of identity change — maps to acmt:006 MdcnCd (Modification Code). Primary AML signals: phone_change (SIM swap), address_change (address control), beneficiary_added / authorised_signer_change (pre-transfer grooming)

idstring uuid
inserted_atstring date-time
legal_entity_idstring uuid required
previous_stateobject nullable

Full JSONB snapshot of the LegalEntity state before this change was applied. System-generated on update_legal_entity — not user-supplied.

tenant_idstring uuid required
updated_atstring date-time

Example response

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "acmt_confirmation_id": "",
  "acmt_instruction_id": "",
  "beneficial_owner_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "change_channel": "web",
  "changes": {},
  "event_status": "pending",
  "event_type": "address_change",
  "id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "inserted_at": "2020-04-20T16:20:00Z",
  "legal_entity_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "previous_state": {},
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "updated_at": "2020-04-20T16:20:00Z"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.