The chat endpoint processes a shopper’s message and returns an AI-generated reply along with ranked product results, filter refinement options, and pagination metadata.
Endpoint No authentication required.
Path Parameters Unique identifier for the conversation session. Generate a new ID per user session.
Request Body (ShopperInput) The user’s free-text shopping message, e.g. "I'm looking for running shoes under $100".
A refinement choice the user selected. Contains category (string) and selection (string).
Price range filter. Contains low_price (number, optional) and high_price (number, optional).
Example Request curl -X POST https://rewardsbot-prod.liquidrewardsapi.com/chat/my-session-id \ -H "Content-Type: application/json" \ -d '{ "chat": "I want wireless headphones under $200" }'
Response (ShopperReply) The AI assistant’s text response to the user.
Products found matching the query. Show StoreInventory fields
The interpreted search query.
Map of source name to array of product objects.
Min and max price across all results.
Optional warning message about product availability or results.
Suggested refinement options for the user. Show RefinementOptions fields
The refinement dimension (e.g., "brand", "size").
Available values to refine by.
Pagination metadata for fetching additional results. Show InventoryPaginationMetadata fields
Ranking session ID for inventory pagination.
Current page index (0-based).
Number of items per page.
Whether a next page exists.
Full URL to fetch the next page.
ISO 8601 expiry timestamp.
Error Responses Status Code Description 422 Unprocessable EntityValidation error in request body
