KintsugiKintsugi

Check whether bulk classification can run

GET/products/classification-status

Report whether POST /products/bulk-classify is worth running, across every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. canClassify is true only when totalProducts meets minProducts and at least one product needs classification work: pending, or a status POST /products/bulk-classify would reset and re-run.

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.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/products/classification-status?minProducts=<minProducts>
minProductsinteger

Minimum product count required for canClassify to be true.

Response

canClassifybooleanRequired

Whether POST /products/bulk-classify is worth running: enough products exist and at least one needs classification work, meaning it is pending or is a status bulk-classify would reset and re-run (partially approved or previously failed classification).

totalProductsintegerRequired

Product count across the resolved organizations.

hasPendingProductsbooleanRequired

Whether any resolved organization has a product in PENDING status.

minProductsintegerRequired

The product count totalProducts must meet for canClassify to be true.

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/classification-status?minProducts=20
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/products/classification-status?minProducts=20
Response
{
"canClassify": false,
"totalProducts": 100,
"hasPendingProducts": false,
"minProducts": 20
}
Check whether bulk classification can run (2026-07-21) | Kintsugi API Reference