API reference · method v0.4

The AI Value Report API

JSON over HTTPS. Base URL https://www.aivaluereport.com. All money is US dollars in whole dollars. Every response carries method_version and as_of, and the headers X-AIVR-Method-Version and X-AIVR-As-Of.

Authentication

Send your API key in the x-api-key header, or as Authorization: Bearer <key>. /v1/companies needs no key. Free accounts get 100 calls a month; keys are issued from your account once checkout opens, or by request during the founding period.

curl -H "x-api-key: $AIVR_KEY" https://www.aivaluereport.com/v1/companies/CRM/ai-pnl

Key fields

Field	Meaning
`ai_investment`	Annual AI spend with low and high range. basis is disclosed (stated by the company), derived (built from stated figures) or modeled (our estimate).
`claimed_value`	Management's quantified AI value claims, annualized, that point at a reported line.
`verified_value`	How far that line beat its expected path (average of own-trend and peer baselines), capped at the claim, never below zero. generous and strict give the range; attribution_weighted weights by the probability each claim is AI-attributed.
`net_ai_return`	verified_value.base − ai_investment.base. best and worst combine the method range with the investment range.
`impact.margin_bps`	Net AI return ÷ revenue, in basis points. −34 means AI costs 0.34% of revenue more than it shows.
`verdict`	Paying off · Partly visible · Not visible · Not testable.
`confidence`	High · Medium · Low, scored 0–5 with its parts: disclosed investment, testable claim, methods agree, clear AI attribution. Describes certainty, not performance.
`productivity_vs_peers`	Revenue per employee change versus the peer median. Context only; comparable=false flags spin-offs and similar breaks.

Errors and limits

Status	When
401	Missing or unknown API key
403	Your plan does not include this endpoint (screens need Scale, Professional or above, or pay as you go)
404	Ticker not covered, or unknown resource
400	Missing required parameter

Pricing

All plans

Plan	Price
Pay as you go ($20 starter pack)	per call, below
Builder: 2,000 calls a month	$79 / month
Scale: 15,000 calls a month, internal use	$599 / month
Commercial: redistribution	from $1,500 / month

Per call: List covered companies Free · Company AI P&L $0.10 · Company AI claims record $0.05 · Company AI investment $0.05 · Verification tests $0.10 · Compare companies $0.25 · Screen companies $0.50 · Sector benchmarks $0.25. MCP tool calls cost the same as the matching endpoint.

GET `/v1/companies`

Free per call

Every covered company with net AI return, verdict and confidence, plus coverage-wide totals.

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/companies"

Response (real data, trimmed)

{
  "summary": {
    "companies": 30,
    "method_version": "0.4",
    "as_of": "2026-09-25"
  },
  "companies": [
    {
      "ticker": "ACN",
      "company": "Accenture plc",
      "sector": "Information Technology / IT Services & Consulting",
      "peer_group": "Technology & services",
      "fiscal_year": "FY2025",
      "net_ai_return": -450468428,
      "verdict": "Partly visible",
      "confidence": "Medium"
    },
    {
      "ticker": "BAC",
      "company": "Bank of America Corporation",
      "sector": "Financials - Diversified Banks",
      "peer_group": "Financials",
      "fiscal_year": "FY2025",
      "net_ai_return": -400000000,
      "verdict": "Not testable",
      "confidence": "Medium"
    }
  ]
}

GET `/v1/companies/{ticker}/ai-pnl`

$0.10 per call

AI investment, claimed value, verified value, net AI return with best and worst case, margin impact, ROI, verdict, confidence breakdown and productivity versus peers.

Parameter	In	Description
`ticker` required	path	Stock ticker, e.g. CRM

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/companies/CRM/ai-pnl"

Response (real data, trimmed)

{
  "ticker": "CRM",
  "company": "Salesforce, Inc.",
  "sector": "Information Technology / Application Software",
  "peer_group": "Technology & services",
  "fiscal_year": "FY2026",
  "currency": "USD",
  "ai_investment": {
    "base": 2696850000,
    "low": 2097550000,
    "high": 3296150000,
    "basis": "modeled"
  },
  "claimed_value": 900000000,
  "verified_value": {
    "base": 800000000,
    "generous": 800000000,
    "strict": 0,
    "attribution_weighted": 680000000
  },
  "net_ai_return": {
    "base": -1896850000,
    "best": -1297550000,
    "worst": -3296150000
  },
  "impact": {
    "margin_bps": -456.8,
    "ai_roi": -0.703,
    "share_of_operating_income": -0.228,
    "share_of_revenue_growth": 0.079
  },
  "verdict": "Partly visible",
  "confidence": {
    "level": "Medium",
    "score": 2,
    "max": 5,
    "parts": [
      {
        "k": "Investment figure",
        "pts": 0,
        "max": 2,
        "note": "Modeled from indirect evidence"
      },
      {
        "k": "Testable claim",
        "pts": 1,
        "max": 1,
        "note": "2 dollar claims mapped to a reported line"
      },
      {
        "k": "Methods agree",
        "pts": 0,
        "max": 1,
        "note": "Peer baseline not available for this test window"
      },
      {
        "k": "Clear AI attribution",
        "pts": 1,
        "max": 1,
  …

GET `/v1/companies/{ticker}/claims`

$0.05 per call

Every quantified AI claim with first-disclosure date, source link and lifecycle (new, upgraded, repeated, revised, downgraded, contradicted, dropped).

Parameter	In	Description
`ticker` required	path	Stock ticker

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/companies/CRM/claims"

Response (real data, trimmed)

{
  "ticker": "CRM",
  "status_counts": {
    "upgraded": 3,
    "dropped": 1,
    "repeated": 3,
    "downgraded": 1,
    "revised": 2
  },
  "claims": [
    {
      "claim_id": "CRM-C01",
      "first_disclosed": "2025-10-15",
      "speaker": "Marc Benioff, Chair & CEO; Robin Washington, CFO/COO",
      "category": "revenue_uplift",
      "function": "client_revenue",
      "paraphrase": "Agentforce annual recurring revenue (customer-paid) grew from ~$440M to over $1.5B within a year.",
      "value": 1500000000,
      "unit": "USD_per_year",
      "specificity": "quantified",
      "latest_status": "upgraded",
      "lifecycle": [
        {
          "date": "2025-10-15",
          "status": "new",
          "note": "Investor Day: agentic AI ARR ~$440M in Q2 FY26 (first standalone Agentforce ARR figure found).",
          "source_url": "https://www.sec.gov/Archives/edgar/data/1108524/000110852425000168/ex991-investordaypressrele.htm"
        },
        {
          "date": "2025-12-03",
          "status": "upgraded",
          "note": "Q3 FY26 release: Agentforce ARR surpassed $500M, +330% Y/Y.",
          "source_url": "https://investor.salesforce.com/news/news-details/2025/Salesforce-Delivers-Record-Third-Quarter-Fiscal-2026-Results-Driven-by-Agentforce--Data-360/default.aspx"
        },
        {
          "date": "2026-02-25",
          "status": "upgraded",
  …

GET `/v1/companies/{ticker}/investment`

$0.05 per call

Assessed-year AI investment with range and basis (disclosed, derived or modeled), plus history by year and how each figure was estimated.

Parameter	In	Description
`ticker` required	path	Stock ticker

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/companies/CRM/investment"

Response (real data, trimmed)

{
  "ticker": "CRM",
  "assessed": {
    "base": 2696850000,
    "low": 2097550000,
    "high": 3296150000,
    "basis": "modeled",
    "period": "2025 (FY2026: Feb 2025-Jan 2026)",
    "arithmetic": "R&D 5,993M x 0.45 = 2,697M (low x0.35 = 2,098M, high x0.55 = 3,296M)",
    "what_included": "Modeled AI share (35-55%, central 45%) of GAAP R&D; share rises over time as Einstein GPT/Agentforce became the product focus. Material AI-related acquisition (not in amount): Informatica, ~$8B, closed 2025-11-18, framed as 'fuel of Agentforce' (https://www.salesforce.com/news/press-releases/2025/11/18/salesforce-completes-acquisition-of-informatica/; price https://techcrunch.com/2025/05/27/salesforce-acquires-informatica-for-8-billion/). FY26 cash acquisitions total $9,268M (https://stockanalysis.com/stocks/crm/financials/cash-flow-statement/). Oct 2025 pledge of $15B over five years in San Francisco (AI incubator, workforce, 'agentic enterprise'): ~$3B/yr, overlaps with opex, not added (https://www.salesforce.com/news/press-releases/2025/10/13/san-francisco-investment/). Salesforce discloses no AI spend figure; AI inference cost sits in cost of revenues and is not separated.",
    "source_url": "https://s205.q4cdn.com/626266368/files/doc_financials/2026/q4/CRM-Q4-FY26-Earnings-Press-Release.pdf"
  },
  "history": [
    {
      "period": "2023 (FY2024: Feb 2023-Jan 2024)",
  …

GET `/v1/companies/{ticker}/tests`

$0.10 per call

How each claim was tested against its statement line: years, line values, verified value by method (own trend, peer difference-in-differences, generous, strict), method agreement and AI-attribution probability.

Parameter	In	Description
`ticker` required	path	Stock ticker

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/companies/CRM/tests"

Response (real data, trimmed)

{
  "ticker": "CRM",
  "tests": [
    {
      "claim_id": "CRM-C01",
      "kind": "revenue",
      "statement_line": "Total revenues",
      "included": true,
      "status": "Tested",
      "years": [
        "FY2024",
        "FY2025",
        "FY2026"
      ],
      "line_values": [
        34857000000,
        37895000000,
        41525000000
      ],
      "acquired_revenue_removed": 399000000,
      "claimed": 800000000,
      "verified": 800000000,
      "range": [
        0,
        800000000
      ],
      "by_method": {
        "generous": 800000000,
        "own_trend": 800000000,
        "strict": 0
      },
      "methods_agree": null,
      "attribution_probability": 0.85,
      "attribution_backend": "heuristic",
      "note": "Agentforce and Data Cloud ARR ~$800M at FY2026 end. Informatica (closed Nov 2025) adds revenue in the test year. CRM-C02 overlaps, excluded."
    }
  ]
}

GET `/v1/compare`

$0.25 per call

Side-by-side AI P&Ls for up to 10 tickers.

Parameter	In	Description
`tickers` required	query	Comma-separated tickers, up to 10

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/compare?tickers=JPM,UNH"

Response (real data, trimmed)

{
  "companies": [
    {
      "ticker": "JPM",
      "net_ai_return": {
        "base": -2000000000,
        "best": 0,
        "worst": -2000000000
      },
      "verdict": "Not visible",
      "confidence": {
        "level": "High"
      }
    },
    {
      "ticker": "UNH",
      "net_ai_return": {
        "base": -1500000000,
        "best": -1400000000,
        "worst": -1600000000
      },
      "verdict": "Not visible",
      "confidence": {
        "level": "High"
      }
    }
  ],
  "missing": []
}

GET `/v1/screen`

$0.50 per call

Filter covered companies. All filters optional and combined with AND. Money thresholds in US dollars. Not included in the Builder plan.

Parameter	In	Description
`verdict`	query	Comma list: Paying off, Partly visible, Not visible, Not testable
`confidence`	query	Comma list: High, Medium, Low
`sector`	query	Sector or peer group text, e.g. Financials
`net_return_gt`	query	Net AI return above (USD)
`net_return_lt`	query	Net AI return below (USD)
`investment_gt`	query	AI investment above (USD)
`verified_gt`	query	Verified value above (USD)
`margin_bps_lt`	query	Margin impact below (basis points)
`testable`	query	true or false

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/screen?verdict=Paying%20off"

Response (real data, trimmed)

{
  "count": 2,
  "companies": [
    {
      "ticker": "KLAR",
      "net_ai_return": {
        "base": 5924468,
        "best": 40000000,
        "worst": -100000000
      },
      "verdict": "Paying off"
    },
    {
      "ticker": "PFE",
      "net_ai_return": {
        "base": 235000000,
        "best": 615000000,
        "worst": -265000000
      },
      "verdict": "Paying off"
    }
  ]
}

GET `/v1/benchmarks`

$0.25 per call

Totals, medians and verdict mix for a peer group (Financials, Health care, Industrials, Technology & services, Consumer & retail, Telecom) or all companies.

Parameter	In	Description
`sector`	query	Peer group or sector text; omit for all companies

Request

curl -H "x-api-key: $AIVR_KEY" \
  "https://www.aivaluereport.com/v1/benchmarks?sector=Financials"

Response (real data, trimmed)

{
  "sector": "Financials",
  "companies": 6,
  "total": {
    "ai_investment": 3968000000,
    "verified_value": 269924468,
    "net_ai_return": -3698075532
  },
  "median": {
    "ai_investment": 431500000,
    "verified_value": 7000000,
    "net_ai_return": -424500000,
    "margin_bps": -57.55256311635977,
    "ai_roi": -0.9844444444444445
  },
  "verdicts": {
    "Not testable": 2,
    "Partly visible": 2,
    "Not visible": 1,
    "Paying off": 1
  }
}

POST `/mcp` · MCP server

Streamable HTTP · JSON-RPC 2.0

Connect any MCP client (Claude, ChatGPT, Cursor, your own agent) as a remote HTTP server. Tools: list_companies (free), get_ai_pnl, get_claims, get_verification_tests, compare_companies, screen_companies, sector_benchmarks. Results come back as JSON text and as structuredContent.

Client config

{
  "mcpServers": {
    "ai-value-report": {
      "type": "http",
      "url": "https://www.aivaluereport.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Raw call

curl -X POST https://www.aivaluereport.com/mcp \
  -H "content-type: application/json" \
  -H "x-api-key: $AIVR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_ai_pnl","arguments":{"ticker":"CRM"}}}'

The AI Value Report API

Authentication

Key fields

Errors and limits

Pricing

GET /v1/companies

GET /v1/companies/{ticker}/ai-pnl

GET /v1/companies/{ticker}/claims

GET /v1/companies/{ticker}/investment

GET /v1/companies/{ticker}/tests

GET /v1/compare

GET /v1/screen

GET /v1/benchmarks

POST /mcp · MCP server

GET `/v1/companies`

GET `/v1/companies/{ticker}/ai-pnl`

GET `/v1/companies/{ticker}/claims`

GET `/v1/companies/{ticker}/investment`

GET `/v1/companies/{ticker}/tests`

GET `/v1/compare`

GET `/v1/screen`

GET `/v1/benchmarks`

POST `/mcp` · MCP server