TVI API Documentation

Closed beta: programmatically request Temporal Validation Index scores. The calculation engine is proprietary and server-side only. Responses return score, classification, and interpretation — not formula components or coefficients.

Pro / Enterprise API keys only. Same engine as the calculator (/api/tvi-run).

Authentication

All API requests require an API key (Pro or Enterprise). Generate keys from the dashboard when enabled for your plan.

Include your API key in the X-API-Key header:

X-API-Key: tvi_your_api_key_here

Rate Limits

Free Plan: No API access
Pro Plan: 1,000 requests per day (UTC)
Enterprise: Custom limits (contact us)

Endpoints

POST /api/tvi

Calculate TVI Score

Compute TVI for any domain with custom inputs.

Request Body

{
  "domain": "viral",
  "inputs": {
    "year": 2007,
    "views": 880000000,
    "users": 200000000,
    "c": 3.0,
    "p": 180,
    "r": 0.5,
    "legacy": 2.5
  }
}

Response (beta — no proprietary components)

{
  "score": 31.1,
  "type": "TVI",
  "domain": "viral",
  "classification": "Foundation",
  "band": "Foundation",
  "interpretation": "Proven staying power; forms lasting infrastructure.",
  "drivers": [
    "Culture & media signals emphasize era-adjusted reach and time-tested relevance.",
    "Classification: Foundation (Foundation band).",
    "Full component weights and coefficients remain proprietary and are not exposed in beta."
  ],
  "beta": true,
  "timestamp": "2026-07-17T12:00:00.000Z",
  "usage": { "used": 1, "limit": 1000 }
}

Domains

viral / culture — media (year, views, users, c, p, r, legacy)
datasets / ai — AI data (year, usage, researchers, c, p, r, legacy)
business — methods (year, adoption, market, c, p, r, legacy)
invest — investments (year, brand, position, era, sus, crisis, leadership)

IP & modelling layers

Inputs go in; score and interpretation come out. The production engine, coefficients, era tables, and component breakdowns are proprietary and are not returned in beta API responses.

Licensed commercial deployments may add domain-specific calibration, higher limits, and contracted disclosure — contact us.

Outputs are interpretive models for evaluation, not deterministic forecasts or investment advice.

Example: cURL

curl -X POST https://tvi-framework.com/api/tvi \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tvi_your_api_key" \
  -d '{
    "domain": "datasets",
    "inputs": {
      "year": 1998,
      "usage": 50000000,
      "researchers": 10000,
      "c": 3.5,
      "p": 180,
      "r": 0.9,
      "legacy": 3
    }
  }'

Support

Questions? Contact api@boonmind.io

The TVI framework should be understood as a structured interpretive modelling system designed to explore persistence, resilience, and durability across time. Its purpose is not to claim deterministic certainty, but to make long-horizon assumptions visible, inspectable, and testable.

← Back to Dashboard