KintsugiKintsugi

Break down products by category

GET/products/overview

Count products by organization, tax category and subcategory across every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. Each row is one organization's count for a category/subcategory. Archived products are never counted. Rows are ordered by organization, then category, then subcategory.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Response

organizationIdstringRequired

Organization this count is for. Send it as Organization-Id to scope a follow-up request to this organization's products.

productCategorystringRequired

Derived display category for the product tax code.

productSubcategorystringRequired

Derived display subcategory for the product tax code.

countintegerRequired

Number of products in scope with this category/subcategory.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
GET /products/overview
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Response
[
{
"organizationId": "orgn_12345",
"productCategory": "Physical",
"productSubcategory": "General Clothing",
"count": 4
}
]
Break down products by category (2026-07-21) | Kintsugi API Reference