Releases Index
List organizations
View .md

List organizations

GET
/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.

Authorization

bearerAuth
headerAuthorizationBearer <relk_… | relu_… | OAuth JWT>

Machine/operator tokens use the relk_ prefix; self-serve read-only user keys use relu_; Sign in with Releases supplies an OAuth access token. Required scope depends on the endpoint.

Query Parameters

q?string

Case-insensitive substring match on name or slug.

category?string

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?integer
Range1 <= value
limit?integer
Range1 <= value
includeEmpty?boolean

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?boolean

Filter to editorially featured orgs only (home-page rail). Default unfiltered.

platform?string

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?"1"

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.

Value in"1"

Response Body

Paginated org list

application/json
  1. response
items*array<>
pagination*
meta?
Example Request
curl -X GET 'https://api.releases.sh/v1/orgs'
Example Response
{  "items": [    {      "id": "string",      "slug": "string",      "name": "string",      "domain": "string",      "description": "string",      "category": "ai",      "avatarUrl": "string",      "featured": true,      "status": "stub",      "sourceCount": 0,      "releaseCount": 0,      "recentReleaseCount": 0,      "lastActivity": "string",      "topProducts": [        "string"      ],      "aliasDomains": [        "string"      ],      "sparkline": [        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0,        0      ],      "trackingRequestedAt": "string"    }  ],  "pagination": {    "page": 1,    "pageSize": 1,    "returned": 0,    "totalItems": 0,    "totalPages": 0,    "hasMore": true  },  "meta": {    "emptyOrgCount": 0  }}