---
title: "Check completeness for a channel"
method: GET
path: "/products/{id}/completeness"
---

# Check completeness for a channel

`GET /products/{id}/completeness`

## Request

- Base URL: `https://www.merchkit.com/api/v1`
- URL: `https://www.merchkit.com/api/v1/products/{id}/completeness`
- Auth: HTTP bearer

Recomputes the product's completeness for one channel on demand. `channel` is REQUIRED — completeness is per-channel. Requirements come from the workspace's attribute rules. Issues carry `acceptable_values` where applicable: exactly what the write path validates against, so the fix loop closes without a human.

Scope: `read:products`.

## Query parameters

- `channel` string, required

## Response `200`

Completeness status.

- object
  - `data` Completeness: A product's readiness for one channel.
    - `product_id` string, uuid, required
    - `channel` string, required
    - `is_complete` boolean, required: No missing (required or recommended) or invalid attributes.
    - `no_requirements` boolean, required: No rule makes any attribute required or recommended for this product (e.g. its category or class is empty), so `is_complete` says nothing about its readiness.
    - `missing_count` integer, required: required_missing_count + recommended_missing_count.
    - `required_missing_count` integer, required
    - `recommended_missing_count` integer, required
    - `invalid_count` integer, required
    - `issues` object[], required
      - `key` string, required
      - `name` string, required
      - `status` 'missing' | 'invalid', required
      - `current_value` unknown, required
      - `requirement` string, required: Requirement level, e.g. `required` or `recommended`.
      - `acceptable_values` string[]: Present for invalid issues with a value constraint — exactly what a write must match.

## Other responses

- `404`: Product or channel not found.

---

[API](https://skmtc.dev/merchkit/apis/merchkit-api.md) - [All operations](https://skmtc.dev/merchkit/apis/merchkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merchkit/apis/merchkit-api/revisions/3062ca814757?raw)