Data Model

Understand Fin-Trak entities.

Design integrations or warehouse pipelines backed by Fin-Trak's canonical data contracts.

  • UUIDs are used across all primary keys for safe replication across regions.
  • Timestamps are ISO 8601 strings stored in UTC. Use the `lastModifiedAt` attribute for sync cursors.
  • Enumerations map to Fin-Trak risk vocabularies (risk level, decision status, screening type).
  • Financial amounts are stored as minor units (cents) alongside currency codes for precision.

Core entities

These resources power APIs, webhooks, and the Fin-Trak dashboard.

Customer

Represents an individual or business with KYC/KYB data, risk scores, tags, and jurisdiction metadata.

Document

Evidence gathered during onboarding. Stores type, issuing country, reference numbers, and review outcomes.

Relationship

Captures beneficial owners, directors, and related accounts with associated risk weightings.

Screening

Immutable record of checks performed, including scoring, triggered rules, and analyst notes.

Transaction

Payment or transfer evaluated by transaction monitoring. Links to screenings and alerts.

Alert

Work item assigned to analysts with dispositions, escalation tiers, and evidence history.