API — TVCRpro

Quick Start

One request to score anything.

POST your interaction content to /api/score and receive a full TVCR composite score in milliseconds.

curl -X POST https://tvcrpro.com/api/score \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"text": "Your interaction content here", "interaction_type": "type1"}'

Authentication

Pass your API key in the X-API-Key request header on every call. Contact atomicarmstrong@proton.me to obtain API access.

Request Schema

POST /api/score

All parameters are sent in the JSON request body.

Parameter	Type	Required	Description
text	string	Yes	The interaction content to score. Full transcript, session log, or document text.
interaction_type	string	No	`"type1"` (AI Session), `"type2"` (AI-Augmented), `"type3"` (Human Review). Default: `"type1"`
token_cost_per_1k	number	No	USD cost per 1,000 tokens consumed. Default: `0.03`
tokens	integer	No	Override the auto-detected token count. Useful when you have exact token data from your LLM provider.
iterations	integer	No	Override the auto-detected prompt/response iteration count.
attendees	object	No	Decision valuation inputs. See sub-fields below.
attendees.count	integer	No	Number of attendees or participants involved in the interaction.
attendees.hourly_rate	number	No	Average fully-loaded hourly rate per attendee (USD).
attendees.meeting_hours	number	No	Duration of the session in hours.
attendees.load_factor	number	No	Overhead multiplier (e.g. `1.3` for 30% overhead). Default: `1.0`
attendees.decision_impact_estimate	number	No	Estimated dollar impact of the decision being made (Layer 3 valuation).

Response Schema

200 OK — Full Response

Every successful call returns the complete TVCR composite score with all sub-dimensions.

{
  "tvcr": {
    "score":   0.847,             // composite score (0 – ∞, normalized)
    "rating":  "High Value",       // Very High / High / Moderate / Low / Minimal
    "formula": "(BVS × PQW) / tokens"
  },

  "bvs": {
    "total":  82,                  // Business Value Score (0 – 100)
    "max":    100,
    "rating": "Strong",
    "dimensions": {
      "summary":    17,              // /20 — executive-grade summary quality
      "clarity":    15,              // /20 — structure and communication clarity
      "solutions":  16,              // /20 — actionable solution quality
      "resolution": 16,              // /20 — outcome resolution strength
      "escalation":  8,              // /10 — appropriate risk escalation
      "decision":   10               // /10 — decision quality and rationale
    }
  },

  "pqs": {
    "average": 78.4,               // Prompt Quality Score average (0 – 100)
    "weight":  0.784,              // PQS weight applied in TVCR formula
    "rating":  "Strong",
    "dimensions": {
      "specificity":   81,           // how precisely the prompt targeted the need
      "completeness":  77,           // whether all necessary context was included
      "framing":       80,           // logical structure of the request
      "intent":        82,           // clarity of desired outcome signal
      "efficiency":    72            // token efficiency of the prompt itself
    }
  },

  "tokens": {
    "count":       1847,             // total tokens (auto-detected or overridden)
    "word_count":  1386,
    "cost_usd":    0.055,           // token cost in USD
    "cost_per_1k": 0.03
  },

  "interaction": {
    "type":        "type1",
    "type_label":  "AI Session",
    "iterations": {
      "count":  4,
      "method": "auto-detected"
    }
  },

  "decision_valuation": {        // present only when attendees is provided
    "layer1_process_cost":    520.00, // Σ (attendee rate × time × load)
    "layer2_opportunity_cost": 156.00, // 30% of process cost by default
    "layer3_decision_impact":  5000.00, // from decision_impact_estimate
    "total_without_impact":   676.00,
    "ai_token_cost":          0.055
  },

  "meta": {
    "api_version": "1.0",
    "engine":      "tvcr-stable",
    "timestamp":   "2026-01-15T14:32:07Z",
    "patent":      "pending"
  }
}

Try It Live

Interactive Playground

Paste any interaction content and score it live against the TVCR API. The same endpoint available to licensees.

Request

Interaction text *

Interaction type

Optional overrides

Token cost / 1k (USD)

Token count override

Decision valuation (attendees)

Attendees

Hourly rate (USD)

Meeting hours

Response

Submit a request to see the live response

This playground calls the live API endpoint at tvcrpro.com/api/score — the same endpoint available to licensees. An API key is required to return real scores.

Integration Examples

Drop into any stack.

The TVCR API is a standard REST endpoint. Here are ready-to-use examples for the most common environments.

const response = await fetch('https://tvcrpro.com/api/score', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key':      'your-api-key'
  },
  body: JSON.stringify({
    text:             'Your interaction content here',
    interaction_type: 'type1',
    token_cost_per_1k: 0.03
  })
});

const data = await response.json();

// Access scores
console.log(data.tvcr.score);   // 0.847
console.log(data.tvcr.rating);  // "High Value"
console.log(data.bvs.total);   // 82
console.log(data.pqs.average); // 78.4

import requests

url     = "https://tvcrpro.com/api/score"
api_key = "your-api-key"

payload = {
    "text":             "Your interaction content here",
    "interaction_type": "type1",
    "token_cost_per_1k": 0.03
}

headers = {
    "Content-Type": "application/json",
    "X-API-Key":     api_key
}

response = requests.post(url, json=payload, headers=headers)
data     = response.json()

# Access scores
print(data["tvcr"]["score"])   # 0.847
print(data["tvcr"]["rating"])  # "High Value"
print(data["bvs"]["total"])   # 82
print(data["pqs"]["average"]) # 78.4

curl -X POST https://tvcrpro.com/api/score \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "text": "Your interaction content here",
    "interaction_type": "type1",
    "token_cost_per_1k": 0.03,
    "attendees": {
      "count": 4,
      "hourly_rate": 150,
      "meeting_hours": 1.5,
      "load_factor": 1.3,
      "decision_impact_estimate": 50000
    }
  }'

# Pretty-print the response
curl -s -X POST https://tvcrpro.com/api/score \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"text": "...", "interaction_type": "type1"}' \
  | python3 -m json.tool

Access & Limits

Rate Limits & Authentication

The TVCR API uses API key authentication. Keys are provisioned per licensee with tier-appropriate rate limits.

Authentication

X-API-Key: your-api-key

Include the X-API-Key header on every request. Missing or invalid keys return a 401 response.

Rate Limits

Tier	Limit	Window
Standard	100 req	per minute
Enterprise	1,000 req	per minute

Error Responses

Status	Code	Meaning
200 OK	—	Success. Full TVCR response returned.
400	bad_request	Missing required field `text`, or malformed JSON body.
401	unauthorized	Missing, invalid, or revoked API key.
429	rate_limited	Request count exceeded the per-minute limit for your tier. Retry after the window resets.
500	server_error	Internal scoring engine error. Retry once; if persistent, contact support.

Get API Access

API keys are issued directly to licensees. To request access, contact atomicarmstrong@proton.me. Include your platform name, estimated request volume, and preferred tier. Enterprise integrations can also be deployed on-premise — no external API calls required.

TVCR Scoring API