---
title: Latest releases (cross-source feed)
description: >-
  Cacheable cross-source feed ordered by (publishedAt DESC, fetchedAt DESC, id
  DESC).
---
# Latest releases (cross-source feed)

`GET https://api.releases.sh/v1/releases/latest`

Cacheable cross-source feed ordered by `(publishedAt DESC, fetchedAt DESC, id DESC)`. `?source=` and `?org=` are mutually exclusive scopes. `?exclude=` strips releases by source type — comma-separated values from `github,scrape,feed,agent`. By default, coverage-side rows (releases that roll up into a canonical release) are hidden; pass `?include_coverage=true` to include them. Prereleases (canaries / alphas / betas / RCs) are also hidden by default — pass `?include_prereleases=true` to surface them, matching the source-feed and MCP defaults. The unfiltered homepage shape is served through KV (`X-Cache: HIT|MISS`); filtered requests bypass cache (`X-Cache: BYPASS`).

**Auth:** optional Bearer token.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `count` | query | integer | no | Number of releases to return. Clamped to `[1, 100]`. |
| `source` | query | string | no | Scope to a single source by typed ID (`src_…`) or slug. Mutually exclusive with `org`. |
| `org` | query | string | no | Scope to an org's sources by typed ID (`org_…`) or slug. Mutually exclusive with `source`. |
| `include_coverage` | query | boolean | no | Include coverage-side rows that normally roll up into a canonical release. |
| `include_prereleases` | query | boolean | no | Include prereleases (canaries / alphas / betas / RCs). Hidden by default to match the source-feed and MCP defaults. |
| `exclude` | query | string | no | Comma-separated source types to exclude. Allowed: `github`, `scrape`, `feed`, `agent`. |
| `since` | query | string | no | Keep only releases published at or after this bound. Accepts an ISO date/datetime or relative shorthand (`90d`, `4w`, `6m`, `2y`). Filters `published_at`; undated releases are dropped. Windowed requests bypass the KV cache (`X-Cache: BYPASS`). |
| `until` | query | string | no | Keep only releases published at or before this bound. Same input formats as `since`; a bare date (`2026-06-25`) includes that whole UTC day. |
| `minImportance` | query | integer | no | Only include releases with AI-scored `importance` >= this value (1–5). Releases with no score (`null`) are excluded when set. Filtered requests bypass the KV cache (`X-Cache: BYPASS`). |

**Responses**

- `200` Latest releases
- `400` Invalid `exclude` value, unparseable `since`/`until`, invalid `minImportance`, or `source` and `org` both supplied
- `404` Source or org not found

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).