---
title: List products
description: 'Returns the paginated {items, pagination} envelope.'
---
# List products

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

Returns the paginated `{items, pagination}` envelope. Filter by `?orgId=` to scope to one org. Filter by `?kind=` to narrow to a specific entity kind.

**Auth:** optional Bearer token.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | query | string | no | Scope results to one organization by ID. |
| `kind` | query | "platform" \| "sdk" \| "mobile" \| "desktop" \| "docs" \| "integration" \| "tool" | no | Filter by entity kind. Direct match on the row's own kind — no inheritance from a parent. One of: platform, sdk, mobile, desktop, docs, integration, tool. |

**Responses**

- `200` Products list
- `400` Invalid kind value

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