---
title: Response message
slug: product-recommendations/docs/response-message
docTags: 
createdAt: 2026-07-30T20:41:30.719Z
---

The response has a property called status with value *OK* for successful requests, *fail* when an error occurs, or warning when some errors are found but a useful result can be returned. If a fail status is returned, a fatal error occurred and the request could not be fulfilled; as a consequence, no product recommendations are included in the response.

The API returns the following information to the client:

| Parameters | Description                                                |                                        |
| ---------- | ---------------------------------------------------------- | -------------------------------------- |
| status     | The status of the request (\*OK\*, \*fail\*, \*warning\*). |                                        |
| errors     | "errors": per                                              |                                        |
|            | code                                                       | Error code                             |
|            | message                                                    | Explanation of the error.              |
| warnings   | "warnings": rty                                            |                                        |
|            | warning                                                    | \`\{"warning": "A warning message."}\` |
| smartRecs  | "smartRecs": ty                                            |                                        |
| info       | AB test info                                               |                                        |

## Success response

If the status is different from *fail*, a success response is returned.

**Example**

```csharp
{
  "status" : "OK",
}
```

## Failure response

If status is equal to *fail* or *warning*, then an errors element is returned after the status property. The value is a list of the errors or warnings encountered. Example:

```csharp
{
      "status" : "fail",
      "errors" : [
                   { "code"    : "MalformedJson",
                     "message" : "Json Parsing exception: Malformed JSON. 
                                  Unexpected character ('{' (code 123)): 
                                  was expecting double-quote to start
                                  field name at character offset 1."      
                    }
      ]
    }
```
