KernelScan Cve Candidates API

Pre-CVE candidates: kernel fixes nominated for a CVE that is not published yet (Pro and Enterprise plans).

GitHub OpenAPI

Operations 4

GET /api/cve-candidates/teaser Cve Candidates Teaser #
GET /api/cve-candidates List Cve Candidates #
GET /api/cve-candidates/{candidate_id} Get Cve Candidate #
GET /api/cve-candidates/{candidate_id}/stable-queue Get Cve Candidate Stable Queue #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kernelscan-io:kernelscan-io-cve-candidates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kernelscan-io-cve-candidates-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KernelScan Cve Candidates API
  description: 'Public REST API for KernelScan — the Linux kernel CVE analyzer. Upload a kernel .config and get a CycloneDX VEX report of affecting CVEs, query the CVE database, and manage product analyses. Authenticate with `Authorization: Bearer ks_live_` (create one at /api/auth/api-keys). The same surface is also available over MCP at /mcp/.'
  version: 1.0.0
  contact:
    name: KernelScan Support
    url: https://kernelscan.io/docs
    email: support@kernelscan.io
  termsOfService: https://kernelscan.io/agb
servers:
- url: https://kernelscan.io
tags:
- name: cve-candidates
  description: 'Pre-CVE candidates: kernel fixes nominated for a CVE that is not published yet (Pro and Enterprise plans).'
paths:
  /api/cve-candidates/teaser:
    get:
      tags:
      - cve-candidates
      summary: Cve Candidates Teaser
      description: 'No auth. ``{"available": false}`` while no plan includes candidates, else

        ``{"available": true, "plan", "plans", "top": [3], "stats"}``: the open

        candidates'' top three as complete examples (the detail record, which never

        carries the threat model) and counts of what the plan gate hides.

        Declared before ``/{candidate_id}``, which would otherwise take the path.'
      operationId: cve_candidates_teaser_api_cve_candidates_teaser_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Cve Candidates Teaser Api Cve Candidates Teaser Get
  /api/cve-candidates:
    get:
      tags:
      - cve-candidates
      summary: List Cve Candidates
      operationId: list_cve_candidates_api_cve_candidates_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
          description: candidate | promoted | closed_without_cve | all
          default: candidate
          title: Status
        description: candidate | promoted | closed_without_cve | all
      - name: severity
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: CRITICAL, HIGH, MEDIUM, LOW
          title: Severity
        description: CRITICAL, HIGH, MEDIUM, LOW
      - name: stable_release
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          description: A stable release that ships the fix, e.g. v7.2.9
          title: Stable Release
        description: A stable release that ships the fix, e.g. v7.2.9
      - name: search
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          description: 'Free text: id, CVE id, name, subject, commit message or component'
          title: Search
        description: 'Free text: id, CVE id, name, subject, commit message or component'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/cve-candidates/{candidate_id}:
    get:
      tags:
      - cve-candidates
      summary: Get Cve Candidate
      operationId: get_cve_candidate_api_cve_candidates__candidate_id__get
      parameters:
      - name: candidate_id
        in: path
        required: true
        schema:
          type: string
          title: Candidate Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/cve-candidates/{candidate_id}/stable-queue:
    get:
      tags:
      - cve-candidates
      summary: Get Cve Candidate Stable Queue
      description: 'Stable/LTS backport status of one candidate''s fix, per active stable

        series (backend#358, contract docs/stable-queue-contract.md §4–§6, shapes

        ``examples/read_candidate.json`` / ``read_candidate_promoted.json``).


        The same gate as ``GET /api/cve-candidates/{id}`` (``_can_view``: the

        resolved entitlement, admins always): anonymous 401, others 403 with the

        upsell only while some plan includes candidates. A promoted candidate

        whose CVE exists returns a pointer to the CVE read, never the rows twice.

        ``Cache-Control: no-store`` (freshness is computed per request).'
      operationId: get_cve_candidate_stable_queue_api_cve_candidates__candidate_id__stable_queue_get
      parameters:
      - name: candidate_id
        in: path
        required: true
        schema:
          type: string
          title: Candidate Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
externalDocs:
  description: KernelScan documentation
  url: https://kernelscan.io/docs