---
title: "List Catalogs"
method: GET
path: "/v1/catalog"
tags: ["Catalogs"]
---

# List Catalogs

`GET /v1/catalog`

Retrieve a summarized list of catalogs.

## Query parameters

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

## Response `200`

List of catalogs.

- Pagination — Pagination response.
  - `Metadata` object, required — Information regarding the pagination.
    - `Scope` CatalogOutListedScope, 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.
  - `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.
  - `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.
  - `Items` CatalogOutListed[], required — Array of items retreived by the query. This is the main content of the response and should be used to display the items.
    - `Id` number, required
    - `Name` string, required — The name of the catalog.
    - `Type` 'Product', required — The type of the catalog.

## 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)