KintsugiKintsugi

Get a product by id

GET/products/{product_id}

Fetch a single product by id. Searched across every organization your credential owns, so no selector is needed for a known id.

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.

Path parameters

product_idstringRequired

The unique identifier of the product.

Response

idstringRequired

Kintsugi's unique identifier for the product.

organizationIdstringRequired

Organization the product belongs to. Send it as Organization-Id to scope a request to this product.

organizationNamestring

Display name of the organization the product belongs to. null when the organization has no name set.

externalIdstringRequired

Your stable identifier for the product, as supplied on create.

skustring[]

SKUs associated with the product. An empty list when it has none.

codestringRequired

Derived product tax code display name.

namestringRequired

Human-readable product name.

descriptionstring

Product description; an empty string when the product has none.

statusPublicProductStatusEnumRequired

Approval status of the product's tax classification.

Available options:APPROVEDPARTIALLY_APPROVEDPENDINGARCHIVED
productCategorystringRequired

Derived display category for the product's tax code.

productSubcategorystringRequired

Derived display subcategory for the product's tax code.

taxExemptbooleanRequired

Effective tax-exemption flag applied by tax calculation.

sourceTaxExemptboolean

Raw tax-exempt signal reported by the source system (audit). null when the source system did not report a signal, which is distinct from an explicit false.

sourcestringRequired

Origin system of the product (e.g. API, SHOPIFY). Any origin outside the published values is reported as OTHER.

Available options:ACUMATICAAIRWALLEXAMAZONAPIAPPLE_APP_STOREBESTBUYBIGCOMMERCEBILL_COMBUNNYCAMPFIRECHARGEBEECHECKOUTCHAMPDEELDUALENTRYEBAYECWIDETSYFACEBOOKFAIREFRESHBOOKSGOOGLE_APP_STOREGOOGLE_EXPRESSGROUPONGUSTOHYPERLINEINSTAGRAMINTUIT_ENTERPRISE_SUITEKICKSTARTERKILL_BILLMACYSMAGENTOMAXIOMERCADO_LIBREMICROSOFT_DYNAMICS_365MODALYSTNETSUITENEWEGGNOCNOCNORDSTROMODOOOPENMETERORBORDWAYOTHERPAYPALPINTERESTPLENTYONEQUICKBOOKSRECURLYRILLETRIPPLINGSAGE-INTACCTSALESFORCESHOPIFYSHOPLINESHOPWARESQUARESPACESTRIPETARGETTIKTOKVERTEX_O_SERIESWALMARTWAYFAIRWISHWIXWOOCOMMERCEXEROZENSKARZOHOZUORA
connectionIdstring

Identifier of the connection that produced the product. null when the product was not produced by a connection (e.g. created manually).

storeNamestring

Display name of the connection (store) that produced the product. null when the product has no connection, or the connection has no store name set.

classificationFailedboolean

Whether automated tax classification failed for the product. null when classification has not been attempted.

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/{product_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/products/{product_id}
Response
{
"id": "prod_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"organizationName": "Acme Corp",
"externalId": "order-1001",
"sku": [
"sku-1001"
],
"code": "Physical",
"name": "Acme Corp",
"description": "Annual software subscription",
"status": "APPROVED",
"productCategory": "Physical",
"productSubcategory": "General Clothing",
"taxExempt": false,
"sourceTaxExempt": false,
"source": "API",
"connectionId": "conn_2mNpQr7Ls8f3k",
"storeName": "Acme Corp",
"classificationFailed": false
}
Get a product by id (2026-07-21) | Kintsugi API Reference