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

​
Create or retrieve

POST /v1/entities — pass a stable external_id from your system. POST /v1/entities/{entity_id}/identity-links POST /v1/entities/{entity_id}/consents

​
Ingest cashflow

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

​
Underwrite

POST /v1/underwrite

​
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.