---
title: "Retrieve answers"
method: GET
path: "/v1/item_questions/{question}/answer"
tags: ["Results"]
---

# Retrieve answers

`GET /v1/item_questions/{question}/answer`

## Request

- Base URL: `https://agent.cnstrc.com`
- URL: `https://agent.cnstrc.com/v1/item_questions/{question}/answer`
- Auth: none required

Retrieve the AI-powered answers to questions for a given item. If the client accepts [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) (text/event-stream content) response will be streamed back, otherwise complete response JSON is returned.

## Path parameters

- `question` string, required: The question provided by the user as free-form text.

## Query parameters

- `key` string, required: The key of the index to use.
- `item_id` string, required: The ID of the item to return answer(s) for.
- `thread_id` string, uuid: A unique identifier for the conversation thread. This ID links multiple requests to the same conversation.
- `variation_id` string: The ID of the variation of the item to return answer(s) for.
- `guard` boolean: Turn the content moderation check on or off. When on, shopper input is screened before the agent processes it.
- `num_results` integer: The number of answers to return.
- `c` string: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.
- `us` string[]: A customer defined context (such as `vip-club-member`) used to evaluate redirect or refined tag rules. Pass multiple segments by passing multiple `us` arguments.
- `ui` string: A customer generated anonymized identifier for a user on a customer website. It should only be sent for logged in customers and helps constructor to tie multiple client and session ID's together to form a behavioral data profile across devices.
- `s` integer: An integer representing the user's session number (starting with `1`), incremented after a 30 minute period of inactivity.
- `i` string: A globally unique identifier for the user browser (or mobile application instance) making the request.

## Response `200`

AI-powered answer to question for a given item.

- AsaItemQuestionsAnswerResponse
  - `qna_result_id` string, required: Questions and answers result ID.
  - `value` string, required: AI-powered answer to question for a given item.
  - `item_results` ItemQuestionsItemResults
    - `request` object
    - `response` ItemQuestionsItemResultsResponse, required
      - `results` Result[], required: List of results in format defined by Constructor product discovery API.
        - `value` string, required: Name of the matched item or variation (if variations are defined).
        - `matched_terms` string[], required: All terms within the item matching the user's query (regardless of whether misspelled).
        - `data` ResultData, required
          - `id` string: The ID of this item as specified in the catalog.
          - `url` string: The URL where the item can be viewed or purchased.
          - `image_url` string: The item's image URL for display in results.
          - `variation_id` string: ID of the selected (best matching) variation. All metadata of the best matching variation will also be merged into the item's `data` object. Returned when [item variation](#) data is defined.
          - `facets` ResultFacet[]: The item's associated facets.
            - `name` string, required
            - `values` union[], required
              - …
          - `groups` ResultGroup[]: The item's associated categories.
            - `group_id` string, required: The ID of the group.
            - `display_name` string: The name of the group as it is displayed to end users.
            - `path` string, required: The path of `group_id`s above this group. `/great-grandparent/grandparent/parent/`
            - `path_list` Path[], required: An array of groups constituting the path.
              - …
        - `variations` ResultVariation[], nullable: An array of this item's variations matching user's query.
          - `data` ResultData, required
            - `id` string: The ID of this item as specified in the catalog.
            - `url` string: The URL where the item can be viewed or purchased.
            - `image_url` string: The item's image URL for display in results.
            - `variation_id` string: ID of the selected (best matching) variation. All metadata of the best matching variation will also be merged into the item's `data` object. Returned when [item variation](#) data is defined.
            - `facets` ResultFacet[]: The item's associated facets.
              - …
            - `groups` ResultGroup[]: The item's associated categories.
              - …
          - `value` string, required
        - `variations_map` union: Variations data in the format requested by `variations_map` query parameter.
          - unknown[]
            - unknown
          - object
  - `follow_up_questions` ItemQuestion[]: AI-powered list of follow-up questions for the given item.
    - `value` string, required: Human-readable question text.
  - `thread_id` string, uuid: A unique identifier for the conversation thread. This ID links multiple requests to the same conversation.

## Other responses

- `400`: Invalid request parameters.
- `422`: Validation Error
- `500`: Internal server error.

---

[API](https://skmtc.dev/constructor/apis/ai-shopping-agent.md) - [All operations](https://skmtc.dev/constructor/apis/ai-shopping-agent/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/ai-shopping-agent/revisions/dbdbd16abddd?raw)