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

# Retrieves answers

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

Retrieves 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 — Enable or disable the moderation check.
- `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 users 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.

- PdpSchemaItemQuestionsApiModelAsaItemQuestionsAnswerResponse
  - `qna_result_id` string, required — Questions and answers result ID.
  - `value` string, required — AI powered answer to question for a given item.
  - `item_results` PdpSchemaItemQuestionsApiModelItemResults
    - `request` object
    - `response` PdpSchemaItemQuestionsApiModelResponse, 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` PdpSchemaItemQuestionsApiModelQuestion[] — 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/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)
