ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

catalog_reports

Build catalogs report

Changed on Jun 4, 2026

Async request to create a report of the catalog owned by the "operation user_account". This endpoint generates a report upon receiving the first approved request of the day. Any following requests with identical parameters will yield the same report even if data has changed.

By default, the "operation user_account" is the token user_account.

Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) 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 Business Access roles on the ad_account: Owner, Admin, Catalogs Manager.

Note: The All Items report is limited to 25 million items per catalog.

post/catalogs/reports

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopescatalogs:read
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/catalogs/reports/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Request body

Response

The request has succeeded.

tokenstring

Token to be used to get the report

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  removed from the //// request property oneOf list
- breaking
  removed from the //// request property oneOf list
- warning
  removed the request property
- warning
  removed the request property /////
- warning
  removed the request property /////
- info
  mapped value for discriminator key ALL_ITEMS changed from to for //// request property
- info
  removed ALL_ITEMS discriminator mapping keys from the //// request property
- info
  added to the //// request property oneOf list
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the success response with the status
Apr 4, 2025v510f9eba4ad97 Revision changes
- info
  api tag catalog_reports added
- info
  api tag catalogs removed
- info
  added ALL_ITEMS discriminator mapping keys to the //// request property
- info
  added ALL_ITEMS discriminator mapping keys to the //// request property
- info
  added the new ALL_ITEMS enum value to the request property /////
- info
  added the new ALL_ITEMS enum value to the request property /////
- info
  added to the //// request property oneOf list
- info
  added to the //// request property oneOf list

Operation history (3 revisions)