Get Product Parents
https://api.flxpoint.com/product/parentsUse this when you want to pull product 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.
This endpoint will fetch back a list of Product Parents.
Request
pagequeryintegerpage number
pageSizequeryintegernumber of elements per page
skusqueryarray[string]Finds elements matching these SKUs. Max 50
updatedAfterquerystring (date-time)Only retrieves back elements that have been updated after the date specified
includeImagesquerybooleanIf "false" is passed, the "image" and "parent.image" nodes will not be populated
includeOptionsquerybooleanIf "false" is passed, the "options" and "parent.options" nodes will not be populated
includeAttributesquerybooleanIf "true" is passed, the "parent.attributes" node will be populated.
includeCategoriesquerybooleanIf "true" is passed, the parent category nodes will be populated.
includeCustomFieldsquerybooleanIf "true" is passed, the "customFields" nodes will be populated.
includeVariantsquerybooleanInclude variants for the parent
includeOverwritesquerybooleanwill include dynamic prices and quantities if they are overwritten with fixed values
includeCustomAggregatesquerybooleanIf "false" is passed, the "customAggregates"(Fields) node will not be populated. Custom Aggregates are similar to custom fields, but they can be aggregated across multiple sources.
includeTagsquerybooleanDetermines if "tags" are returned in the response
includeListingLinksquerybooleanIf `true`, `listingLinks` will be populated with a list of `Listing Parent IDs` that this product is associated to.
deletingquerybooleanIf true will filter down to products being deleted
Example request
/product/parentscurl -X GET "https://api.flxpoint.com/product/parents" \
-H "Accept: application/json" \
-H "X-API-TOKEN: YOUR_TOKEN"Responses
200OKapplication/json
idintegerskustringrequiredtitlestringdescriptionstringmanufacturerstringinsertedAtstring (date-time)updatedAtstring (date-time)archivedbooleancategoryOneobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegercategoryTwoobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegercategoryThreeobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegerimagesarray[ProductImage]productParentIdintegerproductVariantIdintegermd5ChecksumstringoriginalUrlstringfetchedbooleanfetchAttemptsintegerarchivedbooleanidintegerurlstringrequiredsortOrderintegeroptionsarray[ProductParentOption]productParentIdintegeridintegernamestringrequiredglobalOptionIdinteger (int64)optionValuesarray[OptionValue]idintegeroptionIdintegervaluestringpositionintegerglobalPositionintegerglobalOptionValueIdinteger (int64)attributesarray[ProductParentAttribute]idinteger (int64)attributeIdintegerattributeValueIdintegernamestringrequiredoriginalInventoryNamestringvaluestringrequiredoriginalInventoryValuestringisPrivatebooleanmergeToAttributeIdintegermergeToAttributeNamestringmergeToAttributeValueIdintegermergeToAttributeValuestringmergeToAttributeIsPrivatebooleancustomFieldsarray[ProductParentCustomField]idinteger (int64)customFieldValueIdintegercustomFieldIdintegernamestringrequiredvaluestringrequiredoriginalInventoryNamestringoriginalInventoryValuestringmergeToCustomFieldIdintegermergeToCustomFieldNamestringmergeToCustomFieldValueIdintegermergeToCustomFieldValuestringvariantsarray[ProductVariant]priceOverwriteobjectpriceOverwrittenbooleancostOverwrittenbooleanmsrpOverwrittenbooleanmapOverwrittenbooleanshippingCostOverwrittenbooleandropshipFeeOverwrittenbooleandynamicPricenumberdynamicCostnumberdynamicMsrpnumberdynamicMapnumberdynamicShippingCostnumberdynamicDropshipFeenumberquantityOverwriteobjectquantityOverwrittenbooleandynamicQuantityintegerorderVolumeProtectionLockedAtstringlastManualQuantityintegerisLockedByOrderVolumeProtectionboolean"false"productParentIdintegerpricenumbersalePricenumberestimatedShippingCostnumberestimatedDropshipFeenumberinventoryListPricenumberimagesFetchedbooleanproductBuilderIdintegerbuiltWithMappingTemplateIdintegerbuiltAtstring (date-time)rebuiltAtstring (date-time)inventoryLinksarray[ProductVariantInventoryLink]idintegerproductVariantIdintegerinventoryVariantIdinteger (int64)requiredproductAlternativesarray[AlternateVariant]idintegerskustringtitlestringquantityintegercostnumberpricenumberimagestringparentIdintegerreferenceIdentifierstringidintegerskustringrequiredtitlestringmpnstringupcstringeanstringasinstringmsrpnumbermapnumberweightnumberlengthnumberwidthnumberheightnumberinsertedAtstring (date-time)updatedAtstring (date-time)archivedbooleancostnumberquantityintegerpendingFulfillmentQuantityintegerweightUnitobjecthandlestringpoundouncegramkilogramabbreviatedHandlestringlbozgkgdimensionUnitobjecthandlestringinchcentimeterabbreviatedHandlestringincmdimensionalWeightnumberimagesarray[ProductImage]productParentIdintegerproductVariantIdintegermd5ChecksumstringoriginalUrlstringfetchedbooleanfetchAttemptsintegerarchivedbooleanidintegerurlstringrequiredsortOrderintegeroptionsarray[ProductVariantOption]productParentOptionIdintegerglobalOptionValueIdinteger (int64)productVariantIdintegeridintegerpositionintegernamestringrequiredvaluestringrequiredglobalPositionintegerbundlebooleanbundleComponentsarray[ProductBundleComponent]componentQuantityintegerrequiredcomponentProductVariantobjectpriceOverwritePriceOverwritequantityOverwriteQuantityOverwriteproductParentIdintegerpricenumbersalePricenumberestimatedShippingCostnumberestimatedDropshipFeenumberinventoryListPricenumberimagesFetchedbooleanproductBuilderIdintegerbuiltWithMappingTemplateIdintegerbuiltAtstring (date-time)rebuiltAtstring (date-time)inventoryLinksarray[ProductVariantInventoryLink]productAlternativesarray[AlternateVariant]referenceIdentifierstringidintegerskustringrequiredtitlestringmpnstringupcstringeanstringasinstringmsrpnumbermapnumberweightnumberlengthnumberwidthnumberheightnumberinsertedAtstring (date-time)updatedAtstring (date-time)archivedbooleancostnumberquantityintegerpendingFulfillmentQuantityintegerweightUnitWeightUnitdimensionUnitDimensionUnitdimensionalWeightnumberimagesarray[ProductImage]optionsarray[ProductVariantOption]bundlebooleanbundleComponentsarray[ProductBundleComponent]listingLinksarray[ProductVariantListingLink]customAggregateFieldsarray[ProductVariantCustomAggregateField]scheduledToDeleteAtstring (date-time)customFieldsarray[ProductVariantCustomField]parentProductParentdescriptionstringtagsarray[string]requiresFflbooleanimageFetcherEventTriggeredbooleanlinkedSourceCountintegerbundleProductVariantIdintegercomponentProductVariantIdintegerrequiredlistingLinksarray[ProductVariantListingLink]listingVariantIdintegerrequiredchannelIdintegerrequiredcustomAggregateFieldsarray[ProductVariantCustomAggregateField]idinteger (int64)productVariantIdintegeraccountIdintegercustomAggregateFieldobjectidintegeraggregateFieldDataTypeIdintegercustomAggregateFieldOptionIdintegernamestringhandlestringignoreOutOfStockbooleanfalseaccountIdintegernamestringvaluenumbercustomAggregateFieldIdintegerscheduledToDeleteAtstring (date-time)customFieldsarray[ProductVariantCustomField]idinteger (int64)customFieldValueIdintegercustomFieldIdintegernamestringrequiredvaluestringrequiredoriginalInventoryNamestringoriginalInventoryValuestringmergeToCustomFieldIdintegermergeToCustomFieldNamestringmergeToCustomFieldValueIdintegermergeToCustomFieldValuestringparentobjectidintegerskustringrequiredtitlestringdescriptionstringmanufacturerstringinsertedAtstring (date-time)updatedAtstring (date-time)archivedbooleancategoryOneobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegercategoryTwoobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegercategoryThreeobjectaccountIdintegerinsertedAtstring (date-time)updatedAtstring (date-time)customizedbooleanidintegernamestringrequiredparentCategoryIdintegerinventoryCategoryobjectsourceIdintegerproductCategoryIdintegeridintegernamestringrequiredexcludedbooleanparentCategoryIdintegerimagesarray[ProductImage]productParentIdintegerproductVariantIdintegermd5ChecksumstringoriginalUrlstringfetchedbooleanfetchAttemptsintegerarchivedbooleanidintegerurlstringrequiredsortOrderintegeroptionsarray[ProductParentOption]productParentIdintegeridintegernamestringrequiredglobalOptionIdinteger (int64)optionValuesarray[OptionValue]attributesarray[ProductParentAttribute]idinteger (int64)attributeIdintegerattributeValueIdintegernamestringrequiredoriginalInventoryNamestringvaluestringrequiredoriginalInventoryValuestringisPrivatebooleanmergeToAttributeIdintegermergeToAttributeNamestringmergeToAttributeValueIdintegermergeToAttributeValuestringmergeToAttributeIsPrivatebooleancustomFieldsarray[ProductParentCustomField]idinteger (int64)customFieldValueIdintegercustomFieldIdintegernamestringrequiredvaluestringrequiredoriginalInventoryNamestringoriginalInventoryValuestringmergeToCustomFieldIdintegermergeToCustomFieldNamestringmergeToCustomFieldValueIdintegermergeToCustomFieldValuestringvariantsarray[ProductVariant]priceOverwritePriceOverwritequantityOverwriteQuantityOverwriteproductParentIdintegerpricenumbersalePricenumberestimatedShippingCostnumberestimatedDropshipFeenumberinventoryListPricenumberimagesFetchedbooleanproductBuilderIdintegerbuiltWithMappingTemplateIdintegerbuiltAtstring (date-time)rebuiltAtstring (date-time)inventoryLinksarray[ProductVariantInventoryLink]productAlternativesarray[AlternateVariant]referenceIdentifierstringidintegerskustringrequiredtitlestringmpnstringupcstringeanstringasinstringmsrpnumbermapnumberweightnumberlengthnumberwidthnumberheightnumberinsertedAtstring (date-time)updatedAtstring (date-time)archivedbooleancostnumberquantityintegerpendingFulfillmentQuantityintegerweightUnitWeightUnitdimensionUnitDimensionUnitdimensionalWeightnumberimagesarray[ProductImage]optionsarray[ProductVariantOption]bundlebooleanbundleComponentsarray[ProductBundleComponent]listingLinksarray[ProductVariantListingLink]customAggregateFieldsarray[ProductVariantCustomAggregateField]scheduledToDeleteAtstring (date-time)customFieldsarray[ProductVariantCustomField]parentProductParentdescriptionstringtagsarray[string]requiresFflbooleanimageFetcherEventTriggeredbooleanlinkedSourceCountintegercategoryOneIdintegercategoryTwoIdintegercategoryThreeIdintegerimagesFetchedbooleanproductBuilderIdintegerbuiltWithMappingTemplateIdintegerbuiltAtstring (date-time)rebuiltAtstring (date-time)tagsarray[string]listingLinksarray[ProductParentListingLink]listingParentIdintegerrequiredchannelIdintegerrequiredimageFetcherEventTriggeredbooleandescriptionstringtagsarray[string]requiresFflbooleanimageFetcherEventTriggeredbooleanlinkedSourceCountintegercategoryOneIdintegercategoryTwoIdintegercategoryThreeIdintegerimagesFetchedbooleanproductBuilderIdintegerbuiltWithMappingTemplateIdintegerbuiltAtstring (date-time)rebuiltAtstring (date-time)tagsarray[string]listingLinksarray[ProductParentListingLink]listingParentIdintegerrequiredchannelIdintegerrequiredimageFetcherEventTriggeredboolean[
{
"id": 0,
"sku": "string",
"title": "string",
"description": "string",
"manufacturer": "string",
"insertedAt": "2026-04-20T00:00:00Z",
"updatedAt": "2026-04-20T00:00:00Z",
"archived": true,
"categoryOne": {
"accountId": 0,
"insertedAt": "2026-04-20T00:00:00Z",
"updatedAt": "2026-04-20T00:00:00Z",
"customized": true,
"id": 0,
"name": "string",
"parentCategoryId": 0,
"inventoryCategory": {
"sourceId": 0,
"productCategoryId": 0,
"id": 0,
"name": "string",
"excluded": true,
"parentCategoryId": 0
}
},
"categoryTwo": {
"accountId": 0,
"insertedAt": "2026-04-20T00:00:00Z",
"updatedAt": "2026-04-20T00:00:00Z",
"customized": true,
"id": 0,
"name": "string",
"parentCategoryId": 0,
"inventoryCategory": {
"sourceId": 0,
"productCategoryId": 0,
"id": 0,
"name": "string",
"excluded": true,
"parentCategoryId": 0
}
},
"categoryThree": {
"accountId": 0,
"insertedAt": "2026-04-20T00:00:00Z",
"updatedAt": "2026-04-20T00:00:00Z",
"customized": true,
"id": 0,
"name": "string",
"parentCategoryId": 0,
"inventoryCategory": {
"sourceId": 0,
"productCategoryId": 0,
"id": 0,
"name": "string",
"excluded": true,
"parentCategoryId": 0
}
},
"images": [
{
"productParentId": 0,
"productVariantId": 0,
"md5Checksum": "string",
"originalUrl": "string",
"fetched": true,
"fetchAttempts": 0,
"archived": true,
"id": 0,
"url": "string",
"sortOrder": 0
}
],
"options": [
{
"productParentId": 0,
"id": 0,
"name": "string",
"globalOptionId": 0,
"optionValues": [
null
]
}
],
"attributes": [
{
"id": 0,
"attributeId": 0,
"attributeValueId": 0,
"name": "string",
"originalInventoryName": "string",
"value": "string",
"originalInventoryValue": "string",
"isPrivate": true,
"mergeToAttributeId": 0,
"mergeToAttributeName": "string",
"mergeToAttributeValueId": 0,
"mergeToAttributeValue": "string",
"mergeToAttributeIsPrivate": true
}
],
"customFields": [
{
"id": 0,
"customFieldValueId": 0,
"customFieldId": 0,
"name": "string",
"value": "string",
"originalInventoryName": "string",
"originalInventoryValue": "string",
"mergeToCustomFieldId": 0,
"mergeToCustomFieldName": "string",
"mergeToCustomFieldValueId": 0,
"mergeToCustomFieldValue": "string"
}
],
"variants": [
{
"priceOverwrite": {
"priceOverwritten": null,
"costOverwritten": null,
"msrpOverwritten": null,
"mapOverwritten": null,
"shippingCostOverwritten": null,
"dropshipFeeOverwritten": null,
"dynamicPrice": null,
"dynamicCost": null,
"dynamicMsrp": null,
"dynamicMap": null,
"dynamicShippingCost": null,
"dynamicDropshipFee": null
},
"quantityOverwrite": {
"quantityOverwritten": null,
"dynamicQuantity": null,
"orderVolumeProtectionLockedAt": null,
"lastManualQuantity": null,
"isLockedByOrderVolumeProtection": null
},
"productParentId": 0,
"price": 0,
"salePrice": 0,
"estimatedShippingCost": 0,
"estimatedDropshipFee": 0,
"inventoryListPrice": 0,
"imagesFetched": true,
"productBuilderId": 0,
"builtWithMappingTemplateId": 0,
"builtAt": "2026-04-20T00:00:00Z",
"rebuiltAt": "2026-04-20T00:00:00Z",
"inventoryLinks": [
null
],
"productAlternatives": [
null
],
"referenceIdentifier": "string",
"id": 0,
"sku": "string",
"title": "string",
"mpn": "string",
"upc": "string",
"ean": "string",
"asin": "string",
"msrp": 0,
"map": 0,
"weight": 0,
"length": 0,
"width": 0,
"height": 0,
"insertedAt": "2026-04-20T00:00:00Z",
"updatedAt": "2026-04-20T00:00:00Z",
"archived": true,
"cost": 0,
"quantity": 0,
"pendingFulfillmentQuantity": 0,
"weightUnit": {
"handle": null,
"abbreviatedHandle": null
},
"dimensionUnit": {
"handle": null,
"abbreviatedHandle": null
},
"dimensionalWeight": 0,
"images": [
null
],
"options": [
null
],
"bundle": true,
"bundleComponents": [
null
],
"listingLinks": [
null
],
"customAggregateFields": [
null
],
"scheduledToDeleteAt": "2026-04-20T00:00:00Z",
"customFields": [
null
],
"parent": {
"id": null,
"sku": null,
"title": null,
"description": null,
"manufacturer": null,
"insertedAt": null,
"updatedAt": null,
"archived": null,
"categoryOne": null,
"categoryTwo": null,
"categoryThree": null,
"images": null,
"options": null,
"attributes": null,
"customFields": null,
"variants": null,
"categoryOneId": null,
"categoryTwoId": null,
"categoryThreeId": null,
"imagesFetched": null,
"productBuilderId": null,
"builtWithMappingTemplateId": null,
"builtAt": null,
"rebuiltAt": null,
"tags": null,
"listingLinks": null,
"imageFetcherEventTriggered": null
},
"description": "string",
"tags": [
null
],
"requiresFfl": true,
"imageFetcherEventTriggered": true,
"linkedSourceCount": 0
}
],
"categoryOneId": 0,
"categoryTwoId": 0,
"categoryThreeId": 0,
"imagesFetched": true,
"productBuilderId": 0,
"builtWithMappingTemplateId": 0,
"builtAt": "2026-04-20T00:00:00Z",
"rebuiltAt": "2026-04-20T00:00:00Z",
"tags": [
"string"
],
"listingLinks": [
{
"listingParentId": 0,
"channelId": 0
}
],
"imageFetcherEventTriggered": true
}
]401Unauthorized
No schema documented for this status.
OpenAPI fragment
{
"get": {
"summary": "Get Product Parents",
"description": "This endpoint will fetch back a list of Product Parents.",
"parameters": [
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 1
},
"description": "page number"
},
{
"name": "pageSize",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"maximum": 50
},
"description": "number of elements per page"
},
{
"schema": {
"type": "array",
"maxItems": 50,
"example": "SKU123,SKU456,SKU789",
"uniqueItems": true,
"items": {
"type": "string"
}
},
"in": "query",
"name": "skus",
"description": "Finds elements matching these SKUs. Max 50",
"style": "form",
"explode": false
},
{
"schema": {
"type": "string",
"format": "date-time"
},
"in": "query",
"name": "updatedAfter",
"description": "Only retrieves back elements that have been updated after the date specified"
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeImages",
"description": "If \"false\" is passed, the \"image\" and \"parent.image\" nodes will not be populated"
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeOptions",
"description": "If \"false\" is passed, the \"options\" and \"parent.options\" nodes will not be populated"
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeAttributes",
"description": "If \"true\" is passed, the \"parent.attributes\" node will be populated. "
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeCategories",
"description": "If \"true\" is passed, the parent category nodes will be populated."
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeCustomFields",
"description": "If \"true\" is passed, the \"customFields\" nodes will be populated. "
},
{
"name": "includeVariants",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false
},
"description": "Include variants for the parent"
},
{
"name": "includeOverwrites",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false
},
"description": "will include dynamic prices and quantities if they are overwritten with fixed values"
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeCustomAggregates",
"description": "If \"false\" is passed, the \"customAggregates\"(Fields) node will not be populated. Custom Aggregates are similar to custom fields, but they can be aggregated across multiple sources. "
},
{
"name": "includeTags",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false
},
"description": "Determines if \"tags\" are returned in the response"
},
{
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"name": "includeListingLinks",
"description": "If `true`, `listingLinks` will be populated with a list of `Listing Parent IDs` that this product is associated to."
},
{
"schema": {
"type": "boolean"
},
"in": "query",
"name": "deleting",
"description": "If true will filter down to products being deleted"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProductParent"
}
}
}
}
},
"401": {
"description": "Unauthorized"
}
}
}
}