List catalogs
GET {{baseUrl}}/catalogs?bookmark=<string>&page_size=25&ad_account_id=15266090296
Fetch catalogs owned by the operation user_account
.
- By default, the operation user_account
is the token user_account.
Optional: Business Access: Specify an adaccountid (obtained via List ad accounts) to use the owner of that adaccount as the "operation useraccount. In order to do this, the token user_account must have one of the following https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access roles on the ad_account: Owner, Admin, Catalogs Manager.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
bookmark | string | Cursor used to fetch the next page of items | |
page_size | number | Maximum number of items to include in a single page of the response. See documentation on <a href='/docs/getting-started/pagination/'>Pagination</a> for more information. | |
ad_account_id | number | Unique identifier of an ad account. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","catalog_type":"HOTEL","created_at":"\u003cdateTime\u003e","updated_at":"\u003cdateTime\u003e"},{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","catalog_type":"HOTEL","created_at":"\u003cdateTime\u003e","updated_at":"\u003cdateTime\u003e"}],"bookmark":"\u003cstring\u003e"}