{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-28T23:55:00.000Z",
  "record_id": "VXI-EXT-ICE04-CLAUDE-CODE-EXECUTION-COST-USAGE-GAP-01-v1",
  "record_kind": "external_reference",
  "title": "Claude code execution and token-report completeness",
  "system": "Claude",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Can the Claude Messages usage endpoint alone account for code-execution charges?",
  "near_questions": [
    "Where does Claude report code-execution cost?",
    "Can token usage reconcile all sandbox execution charges?",
    "Why can an AI cost report include work absent from the usage report?",
    "What reports are needed for Claude tool-cost completeness?"
  ],
  "supported_claims": [
    {
      "claim": "Claude documents code-execution costs in the cost endpoint under a Code Execution Usage description, while code execution is not included in the usage endpoint. A Messages usage export cannot by itself establish complete tool charges. Reconcile the cost report and invoice scope with token usage for the same organization and period.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "No exact invoice or total-task-cost conclusion from token usage alone; applicable charges and adjustments remain buyer evidence.",
    "Buyer implementation, live runtime enforcement, settled payment, certification or permission to act are not established.",
    "No expanded capabilities or licences for existing INDEX executables."
  ],
  "public_summary": "Claude documents code-execution costs in the cost endpoint under a Code Execution Usage description, while code execution is not included in the usage endpoint. A Messages usage export cannot by itself establish complete tool charges. Reconcile the cost report and invoice scope with token usage for the same organization and period.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Claude: Usage and Cost API",
    "source_url": "https://platform.claude.com/docs/en/manage-claude/usage-cost-api.md",
    "checked_on": "2026-10-28",
    "candidate_record_id": "VXI-EXT-ICE04-CLAUDE-CODE-EXECUTION-COST-USAGE-GAP-01-v1",
    "candidate_record_sha256": "8a9d7332219e07c4a0a63e039e29d9e7245cd68539942a03de5cb98ca2e68d95",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "Claude documents code-execution costs in the cost endpoint under a Code Execution Usage description, while code execution is not included in the usage endpoint. A Messages usage export cannot by itself establish complete tool charges. Reconcile the cost report and invoice scope with token usage for the same organization and period.",
    "required_buyer_context": "Messages usage report; Cost report including description grouping; Matching organization, period and invoice lines. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-28",
    "claim_to_check": "Can the Claude Messages usage endpoint alone account for code-execution charges?",
    "documented_statement": {
      "status": "documented",
      "statement": "Claude documents code-execution costs in the cost endpoint under a Code Execution Usage description, while code execution is not included in the usage endpoint. A Messages usage export cannot by itself establish complete tool charges. Reconcile the cost report and invoice scope with token usage for the same organization and period.",
      "source_ids": [
        "claude-usage-cost"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Review claude code execution and token-report completeness before accepting the buyer claim. A non-token execution charge omitted from a usage endpoint is distinct from model token rate categorization. This is a documentation-review judgment, not an observed deployment outcome.",
      "source_ids": [
        "claude-usage-cost"
      ]
    },
    "buyer_evidence_required": [
      "Messages usage report",
      "Cost report including description grouping",
      "Matching organization, period and invoice lines"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "No exact invoice or total-task-cost conclusion from token usage alone; applicable charges and adjustments remain buyer evidence."
    },
    "unknowns": "Buyer configuration, effective authority, complete usage and final business outcomes were not inspected.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "Buyer configuration, effective authority, complete usage and final business outcomes were not inspected."
    },
    "evidence_sources": [
      {
        "source_id": "claude-usage-cost",
        "url": "https://platform.claude.com/docs/en/manage-claude/usage-cost-api.md",
        "final_url": "https://platform.claude.com/docs/en/manage-claude/usage-cost-api.md",
        "status": 200,
        "captured_at_utc": "2026-10-28T23:49:42.523515+00:00",
        "sha256": "d3ea0a289bff5208121ce715650eb32f01d2ffce8a06dfc556de3d5a383409fd",
        "bytes": 17758,
        "content_type": "text/markdown; charset=utf-8",
        "title": "Claude: Usage and Cost API",
        "hash_basis": "SHA-256 of captured HTTP response body bytes",
        "checked_on": "2026-10-28",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Cost API",
          "How do I track Priority Tier usage?",
          "How do I track code execution usage?",
          "What happens with playground usage?",
          "How is the default workspace represented?"
        ],
        "version_context": "Rolling official documentation captured 2026-10-28; exact response hash is pinned, not a stable vendor release. Verify the deployed API/version and account feature availability. ",
        "rights_review": "Original factual paraphrase and attributed source metadata only. Captured documentation and code remain private; no source prose, examples, images or vendor marks are redistributed. No licence to vendor software or buyer assurance is granted."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Source documentation supports only the stated boundary. Existing licensed checkers analyse supported supplied declarations; they do not query these providers, verify live systems, settle payments or certify compliance.",
    "paid_value": {
      "decision_context": "Review claude code execution and token-report completeness before accepting the buyer claim. A non-token execution charge omitted from a usage endpoint is distinct from model token rate categorization.",
      "free": "Complete review, practical questions, source references and limitations; freely accessible and locally saveable.",
      "single_request": "Unavailable for this publication-only record; historical saved retrieval remains unchanged.",
      "evidence_receipt": "Unavailable for this publication-only record; no new paid retrieval entitlement.",
      "excluded": [
        "Fresh vendor research",
        "Live provider inspection",
        "Runtime enforcement or certification",
        "Expanded executable schemas or licences",
        "Executable AI cost reconciliation"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "Recheck the source and applicable API, account and configuration before current reliance. No monitoring or fresh research is included.",
      "specific_watch": "How do I track code execution usage?"
    },
    "buyer_relevance": "Review claude code execution and token-report completeness before accepting the buyer claim. A non-token execution charge omitted from a usage endpoint is distinct from model token rate categorization.",
    "refusal_conditions": [
      "No exact invoice or total-task-cost conclusion from token usage alone; applicable charges and adjustments remain buyer evidence.",
      "Do not infer buyer deployment conformance or successful business outcomes from source documentation."
    ]
  },
  "niche": {
    "niche_id": "ice04-ai-cost-usage-invoice-assurance",
    "label": "AI Cost, Usage & Invoice Assurance",
    "classification_id": "ai-cost-usage-invoice-assurance",
    "classification_label": "AI Cost, Usage & Invoice Assurance",
    "topic_id": "ai-cost-usage-invoice-assurance",
    "buyer_intent": "Review claude code execution and token-report completeness before accepting the buyer claim. A non-token execution charge omitted from a usage endpoint is distinct from model token rate categorization.",
    "comparison_role": "supplementary_discovery"
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#claude-code-execution-cost-usage-gap",
  "machine_readable_record": "/varexis-index/records/claude-code-execution-cost-usage-gap.json"
}