{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-11T15:37:47.728Z",
  "record_id": "VXI-EXT-FIRST-EPSS-DATED-RETRIEVAL-01-v1",
  "record_kind": "external_reference",
  "title": "EPSS: Dated lookup and bulk retrieval",
  "system": "FIRST EPSS",
  "evidence_family": "exploit_prediction_retrieval",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "How should a vulnerability workflow retrieve EPSS scores and preserve the decision date?",
  "near_questions": [
    "Should bulk enrichment query EPSS per CVE?",
    "Where are historical scores available?",
    "Can a score lookup pin a date?",
    "Which EPSS feed supports dated bulk retrieval?",
    "Why preserve the EPSS model version?",
    "Does a score change imply a changed vulnerability?",
    "How can a prioritisation decision be reproduced?",
    "Is an API version a model version?",
    "Which date should an exported score retain?",
    "Does a current-file link preserve historical values?",
    "When is an individual lookup appropriate?",
    "Does this entry perform live score retrieval?"
  ],
  "supported_claims": [
    {
      "claim": "FIRST recommends its API for individual or small-batch lookups, and daily CSV files for bulk workflows. Historical lookup can pin a score date. Preserve that date and model version: a model change can shift scores without a change in the vulnerability. This documents retrieval choices; VAREXIS does not fetch or refresh EPSS scores through this entry.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "current scores supplied by this documentation entry",
    "unchanged methodology across model versions",
    "successful bulk ingestion without validation"
  ],
  "public_summary": "FIRST recommends its API for individual or small-batch lookups, and daily CSV files for bulk workflows. Historical lookup can pin a score date. Preserve that date and model version: a model change can shift scores without a change in the vulnerability. This documents retrieval choices; VAREXIS does not fetch or refresh EPSS scores through this entry.",
  "related_record_ids": [
    "VXI-AURIC-INDEX-S2-7245220-ENRICHMENT-REVIEW-v1",
    "VXI-EXT-FIRST-EPSS-INTERPRETATION-01-v1"
  ],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "FIRST: Get the EPSS Data",
    "source_url": "https://www.first.org/epss/data.html",
    "checked_on": "2026-10-11",
    "candidate_record_id": "VXI-EXT-FIRST-EPSS-DATED-RETRIEVAL-01-v1",
    "candidate_record_sha256": "5943831af40927e255586374b560e6728dc42556d39f39e44d2cf7a39bed80e3",
    "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": "FIRST recommends its API for individual or small-batch lookups, and daily CSV files for bulk workflows. Historical lookup can pin a score date. Preserve that date and model version: a model change can shift scores without a change in the vulnerability. This documents retrieval choices; VAREXIS does not fetch or refresh EPSS scores through this entry.",
    "required_buyer_context": "Population size, required score date, model version and retained source. No feed acquisition or importer is executed.",
    "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.",
  "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#epss-dated-and-bulk-retrieval",
  "machine_readable_record": "/varexis-index/records/epss-dated-and-bulk-retrieval.json"
}
