---
title: "List Catalog Items"
method: GET
path: "/v1/catalog/{catalogId}/{item}"
tags: ["Catalog Items"]
---

# List Catalog Items

`GET /v1/catalog/{catalogId}/{item}`

Retrieve list of Items from specified catalog.

## Path parameters

- `catalogId` number, required
- `item` 'product' | 'brand' | 'category' | 'merchant', required — Permitted item types.

## Query parameters

- `boundary-id` union — The unique identifier of the boundary item used for paginating results.
  - string
  - number
- `comparison` '>' | '>=' | '<' | '<='
- `limit` number
- `order` 'asc'
- `q` string

## Response `200`

List of Items.

- object — Pagination response.
  - `Metadata` object, required — Information regarding the pagination.
    - `Scope` object, required
      - `comparison` '>' | '>=' | '<' | '<=' — The comparison operator to use for the boundary item.
      - `limit` number — The maximum number of items to return.
      - `order` 'asc' — The order of the items.
      - `boundary-id` number — The unique identifier of the boundary item used for paginating results.
      - `q` string, nullable — The kevelog query to filter the items.
  - `NextQuery` object, required — Query to retrieve the next page of items. The absence of this field indicates that there are no more items to retrieve in that direction at the time of the request.
    - `comparison` '>' | '>=' | '<' | '<=' — The comparison operator to use for the boundary item.
    - `limit` number — The maximum number of items to return.
    - `order` 'asc' — The order of the items.
    - `boundary-id` number — The unique identifier of the boundary item used for paginating results.
    - `q` string, nullable — The kevelog query to filter the items.
  - `PrevQuery` object, required — Query to retrieve the previous page of items. The absence of this field indicates that there are no more items to retrieve in that direction at the time of the request.
    - `comparison` '>' | '>=' | '<' | '<=' — The comparison operator to use for the boundary item.
    - `limit` number — The maximum number of items to return.
    - `order` 'asc' — The order of the items.
    - `boundary-id` number — The unique identifier of the boundary item used for paginating results.
    - `q` string, nullable — The kevelog query to filter the items.

## Other responses

- `400` — Bad request with errors.

---

[API](https://skmtc.net/kevel/apis/engine-apis.md) · [All operations](https://skmtc.net/kevel/apis/engine-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kevel/engine-apis/revisions/0ca55f45aa7d/schema)