Get Product Builder Issues
https://api.flxpoint.com/product/builder/issuesUse this when you want to pull product builder data through the API.
This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.
Get builder issues that require human intervention (mostly based on buidler settings).
This endpoint returns an array of issues for any given `inventoryVariantId` or `productVariantId` as a single inventory variant can match against a potentially unlimited number of product variants that match/share a common identifier (ie UPC) and therefore there can be more than 1 issue for any given inventory/product variant.
It may also contain results where there is no match to an existing product but there is human intervention required IE when the product is archived or when the SKU is already in use by an existing product.
Request
inventoryVariantIdqueryinteger (int64)Get issues that a specific inventory variant is associated with
productVariantIdqueryintegerGet issues that a specific product variant is associated with
Example request
/product/builder/issuescurl -X GET "https://api.flxpoint.com/product/builder/issues" \
-H "Accept: application/json" \
-H "X-API-TOKEN: YOUR_TOKEN"Responses
200OKapplication/json
idinteger (int64)requiredinventoryVariantIdinteger (int64)requiredaccountIdintegerinsertedAtstring (date-time)mappingTemplateIdintegerproductBuilderIdintegermatchedProductVariantIdintegertypestringmismatchduplicate_sourcesarchivedparent_creationparent_attachmentduplicate_skupending_buildinvalid_upcstatusstringkeepneeds_reviewdiscardmatchTypestringupcmpneanasinreference_identifiermaster_skuinventory_skumatchValuestringproductMatchTypestringupcmpneanasinreference_identifiermaster_skutriggeredLinkRulesarray[ProductBuilderTriggeredLinkRule]productBuilderLinkRuleobjectrequiredidintegervalue1stringvalue2stringvalue3stringvalue4stringvalue5stringvalue6stringoutcomeobjectrequiredidintegerhandlestringrequiredfailreviewnamestringtypeobjectrequiredidintegerhandlestringrequiredcost_basiccost_rangebrands_not_equaltitle_containsmpn_not_upcnamestringinventoryVariantIdsarray[integer (int64)]requiredmismatchActionKeepbooleanduplicateSourceActionKeepbooleanduplicateSourceInventoryVariantIdinteger (int64)archivedActionKeepbooleanparentCreationActionKeepbooleanparentAttachmentActionKeepbooleanduplicateSkuProductVariantIdintegerduplicateUseSkustringgeneratedVariantSkustringgeneratedParentSkustringparentAttachmentProductParentIdintegerhasListingsToBuildbooleanfalseinternalBuildErrorMessagestringinternalBuildErrorOnstring (date-time)batchIdstring (uuid)[
{
"id": 0,
"inventoryVariantId": 0,
"accountId": 0,
"insertedAt": "2026-04-20T00:00:00Z",
"mappingTemplateId": 0,
"productBuilderId": 0,
"matchedProductVariantId": 0,
"type": "mismatch",
"status": "keep",
"matchType": "upc",
"matchValue": "string",
"productMatchType": "upc",
"triggeredLinkRules": [
{
"productBuilderLinkRule": {
"id": null,
"value1": null,
"value2": null,
"value3": null,
"value4": null,
"value5": null,
"value6": null,
"outcome": null,
"type": null
},
"inventoryVariantIds": [
null
]
}
],
"mismatchActionKeep": true,
"duplicateSourceActionKeep": true,
"duplicateSourceInventoryVariantId": 0,
"archivedActionKeep": true,
"parentCreationActionKeep": true,
"parentAttachmentActionKeep": true,
"duplicateSkuProductVariantId": 0,
"duplicateUseSku": "string",
"generatedVariantSku": "string",
"generatedParentSku": "string",
"parentAttachmentProductParentId": 0,
"hasListingsToBuild": true,
"internalBuildErrorMessage": "string",
"internalBuildErrorOn": "2026-04-20T00:00:00Z",
"batchId": "string"
}
]400If neither `inventoryVariantId` or `productVariantId` is passed in the GET params.
No schema documented for this status.
401Unauthorized
No schema documented for this status.
OpenAPI fragment
{
"get": {
"summary": "Get Product Builder Issues",
"description": "Get builder issues that require human intervention (mostly based on buidler settings). \n\nThis endpoint returns an array of issues for any given `inventoryVariantId` or `productVariantId` as a single inventory variant can match against a potentially unlimited number of product variants that match/share a common identifier (ie UPC) and therefore there can be more than 1 issue for any given inventory/product variant.\n\nIt may also contain results where there is no match to an existing product but there is human intervention required IE when the product is archived or when the SKU is already in use by an existing product.",
"parameters": [
{
"schema": {
"type": "integer",
"format": "int64"
},
"in": "query",
"name": "inventoryVariantId",
"description": "Get issues that a specific inventory variant is associated with"
},
{
"schema": {
"type": "integer"
},
"in": "query",
"name": "productVariantId",
"description": "Get issues that a specific product variant is associated with"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProductBuilderIssue"
}
}
}
}
},
"400": {
"description": "If neither `inventoryVariantId` or `productVariantId` is passed in the GET params."
},
"401": {
"description": "Unauthorized"
}
}
}
}