---
title: "Retrieve item field statistic"
method: GET
path: "/v1/items_fields_stats/{name}"
tags: ["Item statistics"]
---

# Retrieve item field statistic

`GET /v1/items_fields_stats/{name}`

## Request

- Base URL: `https://ac.cnstrc.com`
- URL: `https://ac.cnstrc.com/v1/items_fields_stats/{name}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

**🔐 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 a list of statistics for a specific field (such as `brand` or `size`).

## Path parameters

- `name` 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`.
- `c` string: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Response `200`

OK

- ItemFieldStatsGetResponse
  - `name` string, required: The item field name on which stats are computed
  - `percentage_presence` number: Percentage presence
  - `type` 'number' | 'string' | 'array' | 'object' | 'boolean' | 'mixed'
  - `example_items` string[]
  - `created_at` string, date-time, required: Item field stats creation date and time
  - `updated_at` string, date-time: Item field stats last update date and time

## 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/catalog-management.md) - [All operations](https://skmtc.dev/constructor/apis/catalog-management/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/catalog-management/revisions/3a9833796fc6?raw)