Waterfall

Authentication

Authenticate with Authorization: Bearer ak_... — see API keys. Requests are scoped to one entity. Pass entityId as a query parameter, JSON field, or x-entity-id header. API keys are already pinned to an entity. A mismatched entityId returns 403.

Endpoints

Run waterfall distribution

GET /api/ledger/waterfall?entityId={entityId}

Runs waterfall distribution and returns allocation results. Supports waterfallId, period, and other parameters.

Create waterfall

POST /api/ledger/waterfall

Body: { "entityId", "name", "tiers", "participants", ... }