---
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/api-features/shopping-overview/'>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, required
    - `id` string, required — ID of the catalog entity.
    - `updated_at` string, date-time, required
    - `name` string, nullable, required — A human-friendly name associated to a catalog entity.
    - `catalog_type` 'RETAIL' | 'HOTEL' | 'CREATIVE_ASSETS', required — Type of the catalog entity.
  - `bookmark` string, nullable

## Other responses

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

## Changes

- **2024-08-14** (v5) `89c27ed39cfd` — 3 info
  - the response property `allOf[subschema #2]/items/items/allOf[subschema #1: db_item]/created_at` became required for the status `200`
  - the response property `allOf[subschema #2]/items/items/allOf[subschema #1: db_item]/id` became required for the status `200`
  - the response property `allOf[subschema #2]/items/items/allOf[subschema #1: db_item]/updated_at` became required for the status `200`
- **2024-04-23** (v5) `f9321315766f` — 1 breaking, 1 warning
  - the `allOf[subschema #2]/` response's property type changed from no type to `object` for status `200`
  - added the new `CREATIVE_ASSETS` enum value to the `allOf[subschema #2]/items/items/allOf[subschema #2]/catalog_type` response property for the response status `200`
- **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.dev/pinterest/apis/pinterest-rest-api/revisions/43134ca41f18?raw)