---
title: "List Catalog Items"
method: GET
path: "/public/catalogs/{catalog_id}/items"
tags: ["Catalogs"]
---

# List Catalog Items

`GET /public/catalogs/{catalog_id}/items`

## Request

- Base URL: `https://catalogapi.rastro.ai/api`
- URL: `https://catalogapi.rastro.ai/api/public/catalogs/{catalog_id}/items`
- Auth: HTTP bearer

List items in a catalog with pagination, search, and filtering.

Args:
    catalog_id: The catalog ID
    limit: Maximum number of items to return (default: 50, max: 1000)
    offset: Number of items to skip
    search: Text search across all fields
    sort: Sort by field and direction (field:asc or field:desc)

Returns:
    Paginated list of catalog items

## Path parameters

- `catalog_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `search` string, nullable: Search across all fields
- `search_query` string, nullable: Alias for search across all fields
- `sort` string, nullable: Sort by field:direction (e.g., created_at:desc)

## Headers

- `X-Organization-Id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rastro-ai/apis/rastro-public-api.md) - [All operations](https://skmtc.dev/rastro-ai/apis/rastro-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rastro-ai/apis/rastro-public-api/revisions/57c8ed4854bb?raw)