---
title: "List catalogs"
method: GET
path: "/catalogs"
tags: ["catalogs"]
---

# List catalogs

`GET /catalogs`

Fetch catalogs owned by the "operation user_account".
- By default, the "operation user_account" is the token user_account.

Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

<a href='/docs/shopping/catalog/'>Learn more</a>

## Query parameters

- `bookmark` string
- `page_size` integer
- `ad_account_id` string

## Response `200`

Success

- object
  - `items` object[], required
    - `created_at` string, date-time
    - `id` string, required — ID of the catalog entity.
    - `updated_at` string, date-time
    - `name` string, nullable, required — A human-friendly name associated to a catalog entity.
    - `catalog_type` 'RETAIL' | 'HOTEL', required — Type of the catalog entity.
  - `bookmark` string, nullable

## Other responses

- `400` — Invalid parameters.
- `401` — Unauthorized access.
- `default` — Unexpected error.

## Changes

- **2023-08-17** (v5) `0ff12596bafd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/get.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/0ff12596bafd/schema)