Skip to main content

Entities

An entity is a person, business, or institution node in the Trust Graph. Every underwrite decision hangs off an entity.

Lifecycle

1

Create or retrieve

POST /v1/entities — pass a stable external_id from your system.
2

Link identity

POST /v1/entities/{entity_id}/identity-links
3

Record consent

POST /v1/entities/{entity_id}/consents
4

Ingest cashflow

POST /v1/entities/{entity_id}/transactions and/or feature snapshots
5

Underwrite

POST /v1/underwrite
6

Audit

GET /v1/entities/{entity_id}/audit-trail

Design tips

  • Keep external IDs stable so sandbox and production graphs stay reconcilable.
  • Prefer normalized transaction ingest over opaque blobs — features and policy both benefit.
  • Outcomes from underwrite feed back into the graph; close the loop with POST .../outcomes.