---
title: "List all catalog entities"
method: GET
path: "/api/rest/v1/catalog"
tags: ["Catalog"]
---

# List all catalog entities

`GET /api/rest/v1/catalog`

## Request

- Base URL: `https://app.componecat.ai`
- URL: `https://app.componecat.ai/api/rest/v1/catalog`
- Auth: none required

Returns entities most recently updated first, as a cursor-paginated list. Pass the returned
`pagination.cursor` as `cursor` to fetch the next page while `pagination.hasMore` is true.

## Query parameters

- `limit` union
  - integer
  - string, int32
- `cursor` string

## Response `200`

OK

- RestApiListResponseOfCatalogEntityListItem: Standard REST API response envelope for a collection of resources.
  - `data` CatalogEntityListItem[], required
    - `id` string, uuid, required: The entity ID.
    - `name` string, required: URL-safe identifier (lowercase slug), unique per kind + namespace. Together with the kind key and namespace it forms the entity ref, e.g. `component://payments/payment-gateway`.
    - `namespace` string, nullable, required: Optional logical grouping namespace. Null when the entity has none.
    - `displayName` string, required: Human-readable name.
    - `kindId` string, uuid, required: ID of the entity kind definition (see `/entity-kind-definitions`).
    - `ownerId` string, uuid, required: ID of the owning team (see `/teams`).
    - `lifecycle` 'EXPERIMENTAL' | 'DEVELOPMENT' | 'PRODUCTION' | 'DEPRECATED' | 'RETIRED', required: Lifecycle stage.
    - `description` string, required: Human-readable description.
  - `pagination` PaginationInfo, required: Pagination metadata for REST API list responses.
    - `cursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/componecat/apis/componecat-rest-api.md) · [All operations](https://skmtc.dev/componecat/apis/componecat-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/componecat/apis/componecat-rest-api/revisions/6c53d4984720?raw)