KintsugiKintsugi
API reference / Get a bulk-classification import's before/after preview

Get a bulk-classification import's before/after preview

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

Return one page of the before/after tax-category preview for a bulk-classification import. Returns 404 if the import does not exist or belongs to an organization your credential cannot access, and 503 if the preview content is temporarily unavailable.

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.

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/bulk-classifications/{import_id}/preview?page=<page>&size=<size>
pageinteger
sizeinteger

Response

importIdstringRequired

The unique identifier of this import.

pageintegerRequired

The page number returned, starting at 1.

sizeintegerRequired

Rows requested per page.

totalintegerRequired

Total previewable rows across all pages.

itemsProductBulkClassificationPreviewRow[]Required

This page's rows.

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}/preview?page=1&size=50
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/products/bulk-classifications/{import_id}/preview?page=1&size=50
Response
{
"importId": "impt_2mNpQr7Ls8f3k",
"page": 1,
"size": 20,
"total": 3,
"items": [
{
"productId": "prod_2mNpQr7Ls8f3k",
"productName": "Widget",
"externalId": "order-1001",
"beforeCategory": "before category",
"afterCategory": "after category",
"beforeSubcategory": "before subcategory",
"afterSubcategory": "after subcategory",
"beforeStatus": "before status",
"afterStatus": "after status"
}
]
}
Get a bulk-classification import's before/after preview (2026-07-21) | Kintsugi API Reference