---
title: List organizations
description: Paginated list of orgs with 30-day release sparklines.
---
# List organizations

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

Paginated list of orgs with 30-day release sparklines. Supports `?q=` substring search on name/slug. Orgs that have no indexed releases yet are hidden by default; pass `?includeEmpty=true` to opt in. The response always carries `meta.emptyOrgCount` so a UI toggle can show how many are hidden without a second round-trip.

**Auth:** optional Bearer token.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `q` | query | string | no | Case-insensitive substring match on name or slug. |
| `category` | query | string | no | Filter to a single canonical category slug (e.g. `ai`, `devops`). Invalid values are ignored (unfiltered). `meta.emptyOrgCount` is scoped to the same filter. |
| `page` | query | integer | no |  |
| `limit` | query | integer | no |  |
| `includeEmpty` | query | boolean | no | Include orgs that have zero indexed releases. Default `false` — empty orgs are stubs from in-flight discovery or broken parsers and surface as noise on the public catalog. |
| `featured` | query | boolean | no | Filter to editorially featured orgs only (home-page rail). Default unfiltered. |
| `platform` | query | string | no | Filter to orgs with a linked account on this platform (e.g. `github`, `x`). Matched case-insensitively. `meta.emptyOrgCount` is scoped to the same filter. |
| `trackingRequested` | query | "1" | no | Admin-only. Pass `1` to restrict to orgs that have stamped `trackingRequestedAt` (the self-serve listing owner-demand signal, #1947), ordered most-recent-first. Items still conform to `OrgListItemSchema` (same envelope as the public list) but carry the additive `trackingRequestedAt` field and zeroed stats — these are self-serve stub orgs with no processed sources yet. Requires admin bearer auth — a non-admin caller gets a 403, the param is never silently ignored. |

**Responses**

- `200` Paginated org list
- `403` Admin scope required for `?trackingRequested=1`

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