---
title: Org release feed (cursor-paginated)
description: 'Returns the org''s combined release feed across all sources, newest-first.'
---
# Org release feed (cursor-paginated)

`GET https://api.releases.sh/v1/orgs/{slug}/releases`

Returns the org's combined release feed across all sources, newest-first. Cursor-paginated — pass `nextCursor` from the previous response as `?cursor=` on the next request. Accepts `?source_type=`, `?kind=`, `?include_coverage=true`, `?include_prereleases=true`, and `?q=` full-text search.

**Auth:** optional Bearer token.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | no | Opaque cursor from a previous response's `pagination.nextCursor`. |
| `limit` | query | integer | no | Max releases to return. Defaults to 20, capped at 100. |
| `source_type` | query | string | no | Filter by source type (e.g. `github`, `feed`, `scrape`). |
| `kind` | query | "platform" \| "sdk" \| "mobile" \| "desktop" \| "docs" \| "integration" \| "tool" | no | Filter by resolved entity kind (source.kind ?? product.kind). One of: platform, sdk, mobile, desktop, docs, integration, tool. |
| `product` | query | string | no | Restrict the feed to one product (slug or `prod_…` id, scoped to this org). Unknown product → 404. |
| `include_coverage` | query | boolean | no | When true, include coverage-side rows (hidden by default). |
| `include_prereleases` | query | boolean | no | When true, include pre-release entries. |
| `q` | query | string | no | Full-text search query applied to release title and content. |
| `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. |
| `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. |
| `slug` | path | string | yes |  |

**Responses**

- `200` Release feed
- `400` Invalid `kind` value, unparseable `since`/`until`, or invalid `minImportance`
- `404` Organization not found

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