Keep product data up-to-date using the Incremental Feed API

Reading HTTP response status and error messages

With every HTTP request, the Incremental Feed API returns a response status. This topic lists and describes some status codes and error messages that Sitecore Discover returns in response to POST requests you send to the Incremental Feed API. You can also refer to the complete list of HTTP response codes that Discover can return.

This topic also provides a detailed description of the error object.

Response status

The following table lists some of the response codes that the Incremental Feed API returns.

HTTP status	Response object	Description
`200 Ok`	EMPTY	Indicates that the request was successful. The product data is updated.
`400 Bad Request`	Error	Indicates the data given in the POST request failed validation. Inspect the response body for details. Fix the error and retry.
`500 Internal Error`	EMPTY	The 500 Internal Server Error indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. You can try sending the request again.

The Error object format in Incremental Feed API response

The following shows an example of an error response that Sitecore Discover returns when a POST request to the Incremental Feed API fails:

{
  "message": "Invalid value type for provided 'attribute",
  "code": "INVALID_ATTRIBUTE_TYPE",
  "type" : "BadRequest",
  "data": {
    "attribute": "final_price",
    "expected_type": "float",
    "product_index": 1,
    "value": false
  }
  {
  "request-id": "0715ad4e-b68f-4a32-8002-d34d77fc292a",
  "error-id": "ec6a5a22-0302-4e91-b086-413e14f3efe0",
}

The error object keys are:

Key	Type	Description
`message`	string	Descriptive message explaining the error.
`code`	string	One of the error code values.
`data`	object	Detailed information specific to the error that is being reported to help understand the exact error. The object attributes depend on the type of error.

Error codes in failed calls to the Incremental Feed API

The following table lists and describes error codes that the Incremental Feed API can return when a POST request fails:

Error code	Description
EMPTY_PRODUCTS	The request does not contain products to update.
EMPTY_SKU	No SKU is specified for the product.
NO_INC_FIELDS	The product does not specify attributes to update.
EMPTY_STORE_ID	A store-specific attribute is specified, but no store ID is provided.
EMPTY_STORE_GROUP_ID	A store ID is provided, but a store group is missing.
NO_INC_FIELDS_FOR_STORE	The product does not contain attributes to update the given store.
INVALID_DOMAIN	The domain provided is not valid.
INCREMENTAL_FEED_NOT_ENABLED	The Incremental Feed service is not enabled for the domain.
DOMAIN_NOT_ACTIVE	The domain provided is not active.
ATTRIBUTE_NOT_FOUND	The provided attribute is not configured in the Customer Engagement Console (CEC).
INVALID_ATTRIBUTE_TYPE	Invalid type for provided attribute value.
ATTRIBUTE_NOT_MARKED_AS_INCREMENTAL	The provided attribute is not configured as eligible for updates using the Incremental Feed API (in the CEC).
EMPTY_LOCALE_LANGUAGE	The `locale_language` attribute is missing. This attribute is required when passing the `locale_country` property.
NOT_SUPPORTED_LOCALE	The domain is not set up to support the provided locale.

If you have suggestions for improving this article, let us know!