{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-09T08:04:16.924Z",
  "record_id": "VXI-EXT-OSV-API-02-v1",
  "record_kind": "external_reference",
  "title": "OSV: API rate and response-size boundaries",
  "system": "OSV.dev",
  "evidence_family": "vulnerability_service_constraints",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does an API with no published rate limit guarantee unlimited retrieval?",
  "near_questions": [
    "Is the OSV API rate limited?",
    "Why can a large OSV response fail?",
    "Does HTTP/2 change the OSV response limit?",
    "Can I assume unlimited vulnerability lookups?",
    "Which endpoint owns a retrieval quota?",
    "Do upstream limits apply to cached advisory services?",
    "What transport should a large advisory query use?",
    "Does no rate limit promise an SLA?",
    "What constraints remain on bulk vulnerability queries?",
    "Should I retain the service-limit review date?",
    "Can a proxy impose its own request limits?",
    "What should an agent check before high-volume retrieval?"
  ],
  "supported_claims": [
    {
      "claim": "OSV currently documents no API rate limit, but limits HTTP/1.1 responses to 32 MiB and recommends HTTP/2 for large responses. This is a dated description of the upstream service, not an availability guarantee or a limit inherited by other providers. Check the actual endpoint and transport before planning retrieval.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "guaranteed throughput or availability",
    "unchanged future service policy",
    "the limits of a downstream service"
  ],
  "public_summary": "OSV currently documents no API rate limit, but limits HTTP/1.1 responses to 32 MiB and recommends HTTP/2 for large responses. This is a dated description of the upstream service, not an availability guarantee or a limit inherited by other providers. Check the actual endpoint and transport before planning retrieval.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "OSV API 1.0: Rate and response-size limits",
    "source_url": "https://google.github.io/osv.dev/api/",
    "checked_on": "2026-10-09",
    "candidate_record_id": "VXI-EXT-OSV-API-02-v1",
    "candidate_record_sha256": "edee3251558f8806f323b9932e0def4749d10af53eac556df414e25ecb355f58",
    "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": "OSV currently documents no API rate limit, but limits HTTP/1.1 responses to 32 MiB and recommends HTTP/2 for large responses. This is a dated description of the upstream service, not an availability guarantee or a limit inherited by other providers. Check the actual endpoint and transport before planning retrieval.",
    "required_buyer_context": "The endpoint operator, HTTP version, expected response size, current service policy and any proxy limits. No throughput benchmark was run.",
    "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#osv-api-service-limits",
  "machine_readable_record": "/varexis-index/records/osv-api-service-limits.json"
}
