---
title: "Get item analytics statistics"
method: GET
path: "/analytics/items/stats"
tags: ["analytics"]
---

# Get item analytics statistics

`GET /analytics/items/stats`

Returns aggregated item analytics for the authenticated business:
duplicate %, similarity distribution, new items timeline,
documentation availability, review status timeline, and active/passive breakdown.

## Query parameters

- `days` integer

## Response `200`

OK

- ModelsItemAnalyticsResponse
  - `ai_classification_clusters` ModelsAIClassificationClusterEntry[]
    - `classification` string
    - `cluster_count` integer
  - `duplicate_erp_records` integer
  - `duplicate_items` integer
  - `duplicate_percent` number — DuplicatePercent: % of ERP records that matched to items (duplicate detection).
  - `merged_documents_count` integer — MergedDocumentsCount: total source documents contributing to merged items.
  - `merged_items_count` integer — MergedItemsCount: number of items linked to more than one source document.
  - `new_items_timeline` ModelsDailyCountEntry[]
    - `count` integer
    - `date` string
  - `review_status_timeline` ModelsReviewStatusTimelineEntry[]
    - `alternative` integer
    - `date` string
    - `duplicate` integer
    - `not_related` integer
    - `pending_review` integer
  - `similar_items` integer
  - `similar_threshold` number — SimilarThreshold: the minimum similarity score used for counting similar items. Defaults to 0.8 but may be overridden per business.
  - `similarity_classes` object — SimilarityClasses: per-class item counts for tenants on the classified similarity taxonomy (duplicate, interchangeable_variant, superseded, product_variant, related_parts, component_of). When present the frontend renders one tile per class instead of the legacy duplicate/similar pair.
  - `total_erp_records` integer
  - `total_items` integer

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/resourcly/apis/resourcly-api.md) · [All operations](https://skmtc.dev/resourcly/apis/resourcly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resourcly/resourcly-api/revisions/989abb88a115/schema)