v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
catalog_reports

Get catalogs report

This returns a URL to a report given a token returned from Build catalogs report. You can use the URL to download the report.

  • 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.

get/catalogs/reports

Query parameters

ad_account_idstring

Unique identifier of an ad account.

tokenstring required

Token returned from the post request creation call

Response

The request has succeeded.

report_status'FINISHED' | 'IN_PROGRESS'
sizenumber nullable

Size of the report in bytes

urlstring nullable

URL to download the report