KintsugiKintsugi
API reference / Get a bulk-classification import's review state

Get a bulk-classification import's review state

GET/products/bulk-classifications/{import_id}/review

Return the validation summary and, once confirmed, the apply progress for a bulk-classification import. Returns 404 if the import does not exist or belongs to an organization your credential cannot access.

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

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

import_idstringRequired

The unique identifier of the import.

Response

importIdstringRequired

The unique identifier of this import.

statusPublicProductImportStatusEnumRequired

Lifecycle status of a bulk-classification import.

Every pre-validation internal status (queued, submitted, virus scan, validating) reports as VALIDATING. A virus-scan failure reports as VALIDATION_FAILURE. An import archived before completion reports as CANCELLED.

Available options:VALIDATINGVALIDATION_SUCCESSVALIDATION_FAILURECONFIRM_PENDINGIMPORT_STARTEDIMPORTINGSUCCESSFAILURECANCELLED
productsToUpdateintegerRequired

Products this import will update once confirmed.

productsToSkipintegerRequired

Rows that failed validation and will not be applied.

productsIgnoredintegerRequired

Rows that matched no change (already at the target category).

skipReasonsProductBulkClassificationSkipReasonCount[]Required

Skipped-row counts, broken down by reason.

hasRejectedArtifactbooleanRequired

Whether a downloadable file of rejected rows exists.

hasPreviewArtifactbooleanRequired

Whether a before/after preview is available.

confirmedBystring

Id of the user who confirmed this import, or null if unconfirmed.

confirmedAtstring

When this import was confirmed, as an RFC-3339 UTC timestamp; null if unconfirmed.

progressImportedinteger

Rows successfully applied so far; null before the apply is confirmed.

progressRowsinteger

Total rows claimed for apply; null before the apply is confirmed.

progressFailedinteger

Rows that failed to apply so far; null before the apply is confirmed.

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.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
GET /products/bulk-classifications/{import_id}/review
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/products/bulk-classifications/{import_id}/review
Response
{
"importId": "impt_2mNpQr7Ls8f3k",
"status": "VALIDATING",
"productsToUpdate": 1,
"productsToSkip": 1,
"productsIgnored": 1,
"skipReasons": [
{
"reason": "INVALID_PRODUCT",
"count": 3
}
],
"hasRejectedArtifact": false,
"hasPreviewArtifact": false,
"confirmedBy": "confirmed by",
"confirmedAt": "2026-07-28T12:00:00Z",
"progressImported": 1,
"progressRows": 1,
"progressFailed": 1
}
Get a bulk-classification import's review state (2026-07-21) | Kintsugi API Reference