---
title: "List sources"
method: GET
path: "/sources"
tags: ["Sources"]
---

# List sources

`GET /sources`

Returns a bare array by default; pass `?envelope=true` for the paginated `{items, pagination}` shape. Filter by `?orgId=`, `?orgSlug=`, `?slug=` (exact source slug — one row per org that has a source with this slug, for detecting an ambiguous bare slug across orgs; distinct from the `?q=` substring search), `?productSlug=`, `?type=`, `?has_feed=`, `?stale=`, `?category=`, `?kind=`, `?independent=true`, `?hasChangelog=false` (sources with no tracked CHANGELOG file), `?minRels30d=N` (sources with at least N visible releases in the last 30 days). Free-text search via `?q=`.

## Query parameters

- `kind` 'platform' | 'sdk' | 'mobile' | 'desktop' | 'docs' | 'integration' | 'tool'

## Response `200`

Sources (bare array unless `?envelope=true`)

- union
  - object[]
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `type` 'github' | 'scrape' | 'feed' | 'agent' | 'appstore' | 'video', required
    - `url` string, required
    - `orgName` string, nullable, required
    - `orgSlug` string, nullable, required
    - `productName` string, nullable, required
    - `productSlug` string, nullable, required
    - `isPrimary` boolean, required
    - `isHidden` boolean, nullable, required
    - `discovery` 'curated' | 'agent' | 'on_demand'
    - `metadata` string, nullable, required
    - `releaseCount` integer, required
    - `latestVersion` string, nullable, required
    - `latestDate` string, nullable, required
    - `lastFetchedAt` string, nullable, required
    - `lastPolledAt` string, nullable, required
    - `fetchPriority` 'normal' | 'low' | 'paused', nullable, required
    - `changeDetectedAt` string, nullable, required
    - `consecutiveNoChange` integer, nullable, required
    - `consecutiveErrors` integer, nullable, required
    - `nextFetchAfter` string, nullable, required
    - `medianGapDays` number, nullable, required
    - `lastRetieredAt` string, nullable, required
    - `kind` 'platform' | 'sdk' | 'mobile' | 'desktop' | 'docs' | 'integration' | 'tool', nullable
    - `stars` integer, nullable
    - `starsFetchedAt` string, nullable
  - object
    - `items` object[], required
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `type` 'github' | 'scrape' | 'feed' | 'agent' | 'appstore' | 'video', required
      - `url` string, required
      - `orgName` string, nullable, required
      - `orgSlug` string, nullable, required
      - `productName` string, nullable, required
      - `productSlug` string, nullable, required
      - `isPrimary` boolean, required
      - `isHidden` boolean, nullable, required
      - `discovery` 'curated' | 'agent' | 'on_demand'
      - `metadata` string, nullable, required
      - `releaseCount` integer, required
      - `latestVersion` string, nullable, required
      - `latestDate` string, nullable, required
      - `lastFetchedAt` string, nullable, required
      - `lastPolledAt` string, nullable, required
      - `fetchPriority` 'normal' | 'low' | 'paused', nullable, required
      - `changeDetectedAt` string, nullable, required
      - `consecutiveNoChange` integer, nullable, required
      - `consecutiveErrors` integer, nullable, required
      - `nextFetchAfter` string, nullable, required
      - `medianGapDays` number, nullable, required
      - `lastRetieredAt` string, nullable, required
      - `kind` 'platform' | 'sdk' | 'mobile' | 'desktop' | 'docs' | 'integration' | 'tool', nullable
      - `stars` integer, nullable
      - `starsFetchedAt` string, nullable
    - `pagination` object, required
      - `page` integer, required
      - `pageSize` integer, required
      - `returned` integer, required
      - `totalItems` integer
      - `totalPages` integer
      - `hasMore` boolean, required

## Other responses

- `400` — Invalid kind value

---

[API](https://skmtc.net/releases/apis/releases-api.md) · [All operations](https://skmtc.net/releases/apis/releases-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/releases/releases-api/revisions/168e32061f53/schema)