How Do I Get the Status of Product Offers?

When you add or update a product offer in a catalog or store, the contents of the offer are validated and it goes through editorial review. That process can take up to 36 hours. To see whether the offer passed the review process, use the Status resource. The resource lets you get the status of product offers that you uploaded to a catalog or store.

The following are the base URIs that you may use to get the Status resource. You may use either URI.

  • The tenant URL shown under Store Settings in the BMC web application

Each HTTP request must include the user's credentials and your developer token. To specify the user's credentials, set either the AuthenticationToken header or the UserName and Password headers, but not both.


The Bing Ads APIs, including Content API, will stop supporting managed user credentials (username and password) beginning August 1, 2018. At your earliest convenience, please migrate your account to use Microsoft accounts. For information, see We're changing the way you sign in. You will also need to change your code to use OAuth for authentication. For details about using OAuth, see Authentication with OAuth.

To specify your developer token, set the DeveloperToken header.

If you manage catalogs on behalf of other customers, you must set the CustomerId header to the customer ID of the customer whose store you're managing, and the CustomerAccountId header to the account ID of any of the customer's accounts that you manage (it doesn't matter which managed account).

You do not need to specify the user's credentials or developer token to download the report; you only need to specify them to get the status.

By default, the Content API uses JSON objects to represent the status. To use XML, set the alt query parameter to XML.

To get the status of product offers, append the following template to the base URI.


Set {bmcMerchantId} to your BMC store ID and set {catalogId} to the ID of the catalog that contains the product offers whose status you want to get.

Send an HTTP GET request to the resulting URL. The response will contain a Status object that contains the number of offers that passed the review process in the last 30 days and the number that failed the review during the same period. If an offer failed the review, the Status resource includes an URL that you can use to download a report that describes why the offer failed.

The following shows an example Status object.

  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": ""

The report identifies the offer that failed but does not provide the timestamp or version control information that you can use to identify which of the updates the report is referring to. For example, if you uploaded an offer 2 days ago and then updated it yesterday, you will not know whether the reported issue is related to the version uploaded 2 days ago or the one uploaded yesterday. However, you may be able to use the item's attributes in the Offer Snippet column of the report to infer which version of the item is being reported.

The report file is ZIP compressed, so you must unzip the file to read the report. There is no limit to the number of reports that the system can store; however, the length of time that the reports are stored is undefined. For information about the contents of the report, see Report Format.

Depending on the activity associated with the catalog, the report can be large. You should not request the report anymore frequently than is necessary. The recommended interval is once per hour.

For a code example that shows how to get the catalog's status and download the report, see Downloading the Catalog Status Report.

The following shows an example report.

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;;$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;;;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;;;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;;;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;;;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;;;N/A"