Data API

KernelDiff data API.

Public API access is currently limited while early access, rate limits, and authentication are finalized. Check back for access details.

Access status

The API is intended for programmatic release lookup, comparison retrieval, distro package metadata, commit evidence, and security-focused views. Public access is not broadly open yet.

Format: JSON
Version prefix: /api/v1
Authentication: Limited-access API key
Pagination: cursor + limit

Core record types

Release, commit, file, trailer, person, subsystem, CVE/security, distro kernel, distro delta, and comparison manifest records use stable IDs so clients can cache and link results.

releasescommitsfilesdistrossecuritypeople

Endpoint overview

GET /api/v1/releases?family=stable&status=current&cursor=&limit=
GET /api/v1/releases/{version}
GET /api/v1/releases/{version}/commits?subsystem=&security=&cursor=&limit=
GET /api/v1/commits/{sha}
GET /api/v1/commits/{sha}/files
GET /api/v1/compare/upstream?from=v7.1.1&to=v7.1.2
GET /api/v1/compare/distro?distro=cachyos&package=linux-cachyos&from=7.1.2-2-cachyos&to=7.1.2-3-cachyos
GET /api/v1/compare/distro-upstream?distro=cachyos&package=linux-cachyos&release=7.1.2-3-cachyos
GET /api/v1/distros
GET /api/v1/distros/{distro}/packages
GET /api/v1/distros/{distro}/packages/{package}/releases/{release}
GET /api/v1/people/{slug}
GET /api/v1/subsystems/{name}
GET /api/v1/security?cve=&subsystem=&fixed_in=&distro=
GET /api/v1/cves/{cveId}

Common filters

family=stable|mainline|longterm|rc|linux-next
distro=cachyos|arch|fedora|ubuntu
package=linux-cachyos|linux|kernel|linux-generic
subsystem=fs/btrfs|net/tls|drivers/gpu/drm/amd
security=true
cve=CVE-YYYY-NNNNN
from=v7.1.1
to=v7.1.2
cursor=<opaque cursor>
limit=25

Comparison response shape

{
  "id": "upstream:v7.1.1...v7.1.2",
  "type": "upstream",
  "source": { "kind": "release", "id": "v7.1.1" },
  "target": { "kind": "release", "id": "v7.1.2" },
  "summary": { "commits": 124, "files": 210, "securitySignals": 4 },
  "sections": {
    "commits": "/api/v1/releases/7.1.2/commits",
    "files": "/api/v1/compare/upstream/files?from=v7.1.1&to=v7.1.2",
    "security": "/api/v1/security?fixed_in=7.1.2"
  }
}