---
title: "List kernels"
method: GET
path: "/api/kernels"
tags: ["kernels"]
---

# List kernels

`GET /api/kernels`

List kernels with optional filtering, sorting, and pagination

## Query parameters

- `search` string — Filter by search term
- `author` union — Filter by author
  - string
  - string[]
- `id` union — Filter by ID
  - string
  - string[]
- `arxivIds` union — Filter by Arxiv ID
  - string
  - string[]
- `filter` union — Filter by tags
  - string
  - string[]
- `sort` 'downloads' | 'likes' | 'lastModified' | 'trendingScore' | 'likes30d' | '_id' | 'id' — Sort field (e.g. downloads, likes, lastModified, trendingScore)
- `direction` '1' | '-1' — Sort direction: 1 for ascending, -1 for descending
- `limit` integer — Maximum number of results to return
- `cursor` string — Pagination cursor from Link header
- `full` boolean — Return full kernel info including author, sha, lastModified, files, gated
- `gated` boolean — Filter by gated
- `expand` union — Display specific fields in the response
  - 'author' | 'cardData' | 'disabled' | 'downloads' | 'downloadsAllTime' | 'gated' | 'lastModified' | 'createdAt' | 'likes' | 'private' | 'sha' | 'files' | 'tags' | 'trendingScore' | 'buildMetadata' | 'supportedDriverFamilies' | 'resourceGroup' | 'arxivIds'
  - string[]

## Response `200`

List of kernels

- object[]
  - `_id` string, required
  - `id` string, required — Kernel ID in format namespace/name
  - `author` string — Namespace (user or organization) of the kernel
  - `private` boolean — Whether the kernel is private
  - `cardData` object — Kernel card metadata
  - `disabled` boolean — Whether the kernel is disabled
  - `downloads` integer — Number of downloads in the last 30 days
  - `downloadsAllTime` integer — Total number of downloads
  - `gated` union — Gated access status
    - boolean
    - 'auto'
    - 'manual'
  - `lastModified` string, date-time — Last modification timestamp
  - `createdAt` string, date-time — Creation timestamp
  - `likes` integer — Number of likes
  - `sha` string — Current commit SHA
  - `files` string[] — List of files in the kernel
  - `tags` string[] — Kernel tags
  - `trendingScore` number — Trending score
  - `buildMetadata` object — Build metadata
    - `compatibility` object
      - `torch` string[], required
      - `os` string[], required
      - `arch` string[], required
    - `backends` object[], required
      - `type` 'cuda' | 'rocm' | 'metal' | 'xpu' | 'cpu', required
      - `hardwareTypes` string[], required
      - `noArchs` unknown
    - `builder` object
      - `version` string, required
      - `sha` string
      - `dirty` boolean
  - `supportedDriverFamilies` string[] — Driver families supported by the kernel (derived from build metadata)
  - `resourceGroup` object — Resource group information
    - `id` string, required
    - `name` string, required
    - `numUsers` number

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/dae0cc3790f0/schema)