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

# API overview

> Decision Platform API — entities, underwrite, decisions, audit. Host status: founder-beta / coming online.

# API overview

The Vence Decision Platform API is a thin path from identity and cashflow signals to an explainable verdict.

## Hosts

| Environment | Host                            | Status                                                                                          |
| ----------- | ------------------------------- | ----------------------------------------------------------------------------------------------- |
| Sandbox     | `https://sandbox.api.vence.one` | Intended hostname — **founder-beta / coming online**; use the base URL provisioned for your org |
| Production  | `https://api.vence.one`         | Intended hostname — **coming online**; not public live DNS to assume today                      |

Authenticate with `Authorization: Bearer <api_key>`. OpenAPI lives at `GET /openapi.json` on each **provisioned** host. Interactive exploration also lives in Console → Playground when your org has API access.

## Core resources

| Method | Path                                         | Purpose                                              |
| ------ | -------------------------------------------- | ---------------------------------------------------- |
| `POST` | `/v1/entities`                               | Create or retrieve an entity                         |
| `GET`  | `/v1/entities/{entity_id}`                   | Retrieve an entity                                   |
| `POST` | `/v1/entities/{entity_id}/identity-links`    | Link identity                                        |
| `POST` | `/v1/entities/{entity_id}/consents`          | Record consent                                       |
| `POST` | `/v1/entities/{entity_id}/transactions`      | Ingest transactions (`Idempotency-Key`)              |
| `POST` | `/v1/entities/{entity_id}/feature-snapshots` | Feature snapshots                                    |
| `GET`  | `/v1/entities/{entity_id}/audit-trail`       | Entity audit trail                                   |
| `POST` | `/v1/underwrite`                             | Request an underwriting decision (`Idempotency-Key`) |
| `GET`  | `/v1/decisions/{decision_id}`                | Retrieve a decision                                  |
| `GET`  | `/v1/decisions/{decision_id}/replay`         | Replay policy evaluation                             |
| `POST` | `/v1/decisions/{decision_id}/reviews`        | Submit human review                                  |
| `POST` | `/v1/decisions/{decision_id}/outcomes`       | Record outcomes                                      |
| `GET`  | `/v1/usage`                                  | Usage summary                                        |
| `POST` | `/v1/webhook-test`                           | Send a test webhook                                  |

## Design

The contract stays thin and stable — expand via Console and webhooks rather than bespoke surface area. Sandbox and production share the same shapes; keys and data stay environment-isolated. Live financial underwriting is gated separately from sandbox demos.

Next: [Quickstart](/developers/quickstart), [Webhooks](/developers/webhooks), [Underwrite](/guides/underwrite).