List all catalogs

Returns a list of all your catalogs.


CampaignId optional

Id of the Program (formerly known as campaign) to which the catalog belongs.

Status optional

What state of use the catalog is in. If no enum is added, all catalog statuses can be returned.

View possible enum values
ACTIVELive catalogs that partners can view.
CLOSEDProduct catalogs that have been closed by
DEACTIVATEDProduct catalogs that were deactivated by an account user.
PENDINGProduct catalogs that are still pending activation.


Returns an array of catalogs up to a limit dictated by @pagesize. Each entry in the array is a separate catalog. If no catalogs meet the criteria, the resulting array will be empty. This request should never return an error.

Example Request

curl '<AccountSID>/Catalogs' \
  -X GET \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -d 'Status=ACTIVE' \

Example Response

  "@page": "1",
  "Catalogs": [
      "Id": "1234",
      "Name": "ACME Catalog",
      "Filename": "anvils.xml",
      "AdvertiserId": "7777777",
      "CampaignId": "1000",
      "Status": "PENDING",
      "NumberOfItems": "25",
      "DateLastUpdated": "",
      "UploadMethod": "IMPACT_RADIUS_FTP_SERVER",
      "ItemsUri": "/Advertisers/<AccoutnSID>/Catalogs/1234/Items",
      "Uri": "/Advertisers/<AccountSID>/Catalogs/1234"