---
title: "Retrieve item"
method: GET
path: "/v2/items/{item_id}"
tags: ["Items"]
---

# Retrieve item

`GET /v2/items/{item_id}`

**🔐 This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).**
For authenticating with Bearer token, required scopes are: `catalog(r)`.

Retrieve an item.

## Path parameters

- `item_id` string, required

## Query parameters

- `key` string, required — The key of the index to use.
- `section` string — The section of the index to use. Defaults to `Products`.

## Response `200`

OK

- ItemGetResponse
  - `id` string, required — The ID of the item, must be unique.
  - `name` string, required — The name of the item, as it will appear in the results. Contains at least one alphanumeric character.
  - `suggested_score` integer — A number that will influence the item's initial ranking relative to other item scores (the higher the score, the higher in the list of suggestions the item will appear).
  - `data` ItemMetadataResponse — Additional data about item. In addition to the listed properties you can also provide any other information you want to associate with that item. No special validation is made for that data.
    - `keywords` string[] — An array of keywords for this item. Keywords are useful if you want a product name to appear when a user enters a search term that isn't in the product name itself.
    - `url` string — A URL to directly send the user after selecting the item. Might be required in some cases. Please contact support@constructor.io if you have questions around that.
    - `image_url` string — A URL that points to an image you'd like displayed next to some item (only applicable when url is supplied).
    - `facets` Facets
    - `group_ids` string[] — You can associate each item with one or more groups (i.e. categories). To set up a group hierarchy please contact support@constructor.io group_ids can be used as filters in search, autosuggest, and browse requests.
    - `description` string — A description for this item. The maximum length of this field is 4000 characters.
    - `active` boolean
  - `updated_at` string, date-time, required — A date when the item or any of item's variations were updated.

## Other responses

- `400` — Validation Error
- `401` — Credentials are not passed or action is forbidden.
- `403` — The supplied token does not have the required permissions.
- `404` — Not Found
- `429` — Rate limit breached

---

[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)