Sign in
Party Activity Snapshots

Create party activity snapshot

Changed on

Creates a new party activity snapshot for an AccountHolder covering a reporting window. Use daily/weekly/monthly cadence for ongoing CDD (FATF Rec 10) and quarterly for SAR-narrative evidence (FinCEN 31 CFR §1020.320).

post/api/party-activity-snapshots

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/party-activity-snapshots
  • Auth: none required

Request body

account_holder_idstring uuid required
high_risk_transaction_countinteger

Transactions exceeding risk thresholds

kyc_status_at_end'not_started' | 'in_progress' | 'approved' | 'rejected' | 'expired' nullable

AccountHolder.kyc_status at period close

kyc_status_at_start'not_started' | 'in_progress' | 'approved' | 'rejected' | 'expired' nullable

AccountHolder.kyc_status at period open

notesstring nullable

Free-text analyst notes

period_endstring date required

End of the reporting period (inclusive)

period_startstring date required

Start of the reporting period (inclusive)

period_type'daily' | 'weekly' | 'monthly' | 'quarterly' required

Reporting period cadence — daily/weekly/monthly snapshots feed ongoing CDD (FATF Rec 10); quarterly snapshots support SAR narrative evidence (FinCEN 31 CFR §1020.320).

risk_level_at_end'low' | 'medium' | 'high' | 'very_high' | 'prohibited' nullable

AccountHolder.risk_level at period close

risk_level_at_start'low' | 'medium' | 'high' | 'very_high' | 'prohibited' nullable

AccountHolder.risk_level at period open

sar_indicatorboolean

SAR (Suspicious Activity Report) filing consideration flag

screening_hitsinteger

Potential/confirmed screening matches

tenant_idstring uuid required
total_credit_amountinteger

Total credit amount (minor currency units)

total_debit_amountinteger

Total debit amount (minor currency units)

total_screeningsinteger

Compliance screenings run in the period

transaction_countinteger

Transactions in the period

Example request

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "high_risk_transaction_count": 0,
  "kyc_status_at_end": "not_started",
  "kyc_status_at_start": "not_started",
  "notes": "",
  "period_end": "2020-04-20",
  "period_start": "2020-04-20",
  "period_type": "daily",
  "risk_level_at_end": "low",
  "risk_level_at_start": "low",
  "sar_indicator": false,
  "screening_hits": 0,
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "total_credit_amount": 0,
  "total_debit_amount": 0,
  "total_screenings": 0,
  "transaction_count": 0
}

Changes

  • e99ccd17df53Revision changes
    • info

      added the new prohibited enum value to the request property

    • info

      added the new prohibited enum value to the request property