> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vence.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities

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

### Link identity

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

### Record consent

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

## Related

* [Trust Graph](/platform/trust-graph)
* [Underwrite](/guides/underwrite)
* [API overview](/developers/api-overview)