FlxpointAPI Help CenterBeta

Get Inventory Variant

gethttps://api.flxpoint.com/inventory/variant/{variantId}

Use this when you want to pull inventory data through the API.

🔑 X-API-TOKEN⏱ 2 req/sToken: Account · Source · Channel

This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.

Request

Query parameters
  • includeParentqueryboolean

    If "true" is passed, the "parent" node will be populated with Parent information. NOTE : The "variants" will be empty in this node to prevent circular references.

  • includeImagesqueryboolean

    If "false" is passed, the "image" and "parent.image" nodes will not be populated

  • includeOptionsqueryboolean

    If "false" is passed, the "options" and "parent.options" nodes will not be populated

  • includeAttributesqueryboolean

    If "true" is passed, the "parent.attributes" node will be populated.

  • includeCategoriesqueryboolean

    If "true" is passed, the parent category nodes will be populated.

  • includeCustomFieldsqueryboolean

    If "true" is passed, the "customFields" nodes will be populated.

  • includeCustomAggregatesqueryboolean

    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.

  • includeLinkedProductVariantsqueryboolean

    If "false" is passed, the "linkedProductVariants" node will not be populated.

Example request

get/inventory/variant/{variantId}
curl -X GET "https://api.flxpoint.com/inventory/variant/{variantId}" \
  -H "Accept: application/json" \
  -H "X-API-TOKEN: YOUR_TOKEN"

Responses

200OKapplication/json
sourceIdinteger
inventoryParentIdinteger
supplierVariantIdstring
shippingCostnumber
dropshipFeenumber
inventoryListPricenumber
referenceIdentifierstring
inventoryVariantIdstring (int64)deprecated
committedQuantityinteger
incomingQuantityinteger
quantityinteger
totalQuantityinteger
idinteger (int64)
accountIdintegerdeprecated
skustringrequired
titlestring
mpnstring
masterSkustring
If available from your data source populate with your primary product master SKU to enable easily linking to your existing products or as the foundation to build new product master SKUs from.
upcstring
eanstring
asinstring
msrpnumber
mapnumber
weightnumber
lengthnumber
widthnumber
heightnumber
insertedAtstring (date-time)
updatedAtstring (date-time)
totalQuantityLastChangedAtstring (date-time)
archivedboolean
costnumber
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
dimensionalWeightnumber
imagesarray[InventoryImage]
idinteger (int64)
sourceIdinteger
inventoryParentIdinteger
inventoryVariantIdinteger (int64)
hashstring
originalUrlstring
urlstringrequired
sortOrderinteger
optionsarray[InventoryVariantOption]
inventoryParentOptionIdinteger
inventoryVariantIdinteger (int64)
idinteger (int64)
namestringrequired
valuestringrequired
customAggregateFieldsarray[InventoryVariantCustomAggregateField]
idinteger (int64)
sourceVariantIdinteger (int64)
accountIdinteger
customAggregateFieldobject
idinteger
aggregateFieldDataTypeIdinteger
customAggregateFieldOptionIdinteger
namestring
handlestring
ignoreOutOfStockboolean
default false
accountIdinteger
namestring
valuenumber
customAggregateFieldIdinteger
parentobject
sourceIdinteger
restrictedboolean
variantCountinteger
idinteger
accountIdinteger
skustringrequired
titlestring
descriptionstring
manufacturerstring
insertedAtstring (date-time)
updatedAtstring (date-time)
archivedboolean
categoryOneobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
categoryTwoobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
categoryThreeobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
imagesarray[InventoryImage]
idinteger (int64)
sourceIdinteger
inventoryParentIdinteger
inventoryVariantIdinteger (int64)
hashstring
originalUrlstring
urlstringrequired
sortOrderinteger
optionsarray[InventoryParentOption]
inventoryParentIdinteger
idinteger
namestringrequired
attributesarray[InventoryParentAttribute]
idinteger (int64)
attributeIdinteger
attributeValueIdinteger
namestringrequired
originalInventoryNamestring
valuestringrequired
originalInventoryValuestring
isPrivateboolean
mergeToAttributeIdinteger
mergeToAttributeNamestring
mergeToAttributeValueIdinteger
mergeToAttributeValuestring
mergeToAttributeIsPrivateboolean
customFieldsarray[InventoryParentCustomField]
idinteger (int64)
customFieldValueIdinteger
customFieldIdinteger
namestringrequired
valuestringrequired
originalInventoryNamestring
originalInventoryValuestring
mergeToCustomFieldIdinteger
mergeToCustomFieldNamestring
mergeToCustomFieldValueIdinteger
mergeToCustomFieldValuestring
variantsarray[InventoryVariant]
sourceIdinteger
inventoryParentIdinteger
supplierVariantIdstring
shippingCostnumber
dropshipFeenumber
inventoryListPricenumber
referenceIdentifierstring
inventoryVariantIdstring (int64)deprecated
committedQuantityinteger
incomingQuantityinteger
quantityinteger
totalQuantityinteger
idinteger (int64)
accountIdintegerdeprecated
skustringrequired
titlestring
mpnstring
masterSkustring
If available from your data source populate with your primary product master SKU to enable easily linking to your existing products or as the foundation to build new product master SKUs from.
upcstring
eanstring
asinstring
msrpnumber
mapnumber
weightnumber
lengthnumber
widthnumber
heightnumber
insertedAtstring (date-time)
updatedAtstring (date-time)
totalQuantityLastChangedAtstring (date-time)
archivedboolean
costnumber
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
dimensionalWeightnumber
imagesarray[InventoryImage]
idinteger (int64)
sourceIdinteger
inventoryParentIdinteger
inventoryVariantIdinteger (int64)
hashstring
originalUrlstring
urlstringrequired
sortOrderinteger
optionsarray[InventoryVariantOption]
inventoryParentOptionIdinteger
inventoryVariantIdinteger (int64)
idinteger (int64)
namestringrequired
valuestringrequired
customAggregateFieldsarray[InventoryVariantCustomAggregateField]
idinteger (int64)
sourceVariantIdinteger (int64)
accountIdinteger
customAggregateFieldobject
idinteger
aggregateFieldDataTypeIdinteger
customAggregateFieldOptionIdinteger
namestring
handlestring
ignoreOutOfStockboolean
default false
accountIdinteger
namestring
valuenumber
customAggregateFieldIdinteger
parentobject
sourceIdinteger
restrictedboolean
variantCountinteger
idinteger
accountIdinteger
skustringrequired
titlestring
descriptionstring
manufacturerstring
insertedAtstring (date-time)
updatedAtstring (date-time)
archivedboolean
categoryOneobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
categoryTwoobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
categoryThreeobject
sourceIdinteger
productCategoryIdinteger
A product Category this inventory category is mapped to
idinteger
namestringrequired
excludedboolean
parentCategoryIdinteger
imagesarray[InventoryImage]
idinteger (int64)
sourceIdinteger
inventoryParentIdinteger
inventoryVariantIdinteger (int64)
hashstring
originalUrlstring
urlstringrequired
sortOrderinteger
optionsarray[InventoryParentOption]
inventoryParentIdinteger
idinteger
namestringrequired
attributesarray[InventoryParentAttribute]
idinteger (int64)
attributeIdinteger
attributeValueIdinteger
namestringrequired
originalInventoryNamestring
valuestringrequired
originalInventoryValuestring
isPrivateboolean
mergeToAttributeIdinteger
mergeToAttributeNamestring
mergeToAttributeValueIdinteger
mergeToAttributeValuestring
mergeToAttributeIsPrivateboolean
customFieldsarray[InventoryParentCustomField]
idinteger (int64)
customFieldValueIdinteger
customFieldIdinteger
namestringrequired
valuestringrequired
originalInventoryNamestring
originalInventoryValuestring
mergeToCustomFieldIdinteger
mergeToCustomFieldNamestring
mergeToCustomFieldValueIdinteger
mergeToCustomFieldValuestring
variantsarray[InventoryVariant]
sourceIdinteger
inventoryParentIdinteger
supplierVariantIdstring
shippingCostnumber
dropshipFeenumber
inventoryListPricenumber
referenceIdentifierstring
inventoryVariantIdstring (int64)deprecated
committedQuantityinteger
incomingQuantityinteger
quantityinteger
totalQuantityinteger
idinteger (int64)
accountIdintegerdeprecated
skustringrequired
titlestring
mpnstring
masterSkustring
If available from your data source populate with your primary product master SKU to enable easily linking to your existing products or as the foundation to build new product master SKUs from.
upcstring
eanstring
asinstring
msrpnumber
mapnumber
weightnumber
lengthnumber
widthnumber
heightnumber
insertedAtstring (date-time)
updatedAtstring (date-time)
totalQuantityLastChangedAtstring (date-time)
archivedboolean
costnumber
weightUnitWeightUnit
dimensionUnitDimensionUnit
dimensionalWeightnumber
imagesarray[InventoryImage]
optionsarray[InventoryVariantOption]
customAggregateFieldsarray[InventoryVariantCustomAggregateField]
parentInventoryParent
linkedProductVariantsarray[ProductVariantInventoryLink]
scheduledToDeleteAtstring (date-time)
customFieldsarray[InventoryVariantCustomField]
allowBackordersboolean
binLocationstring
An identifier representing the location of a bin in an internal warehouse
descriptionstring
contentUpdatedAtstring (date-time)
requiresFflboolean
Indicate if FFL information will be required to fulfill this inventory variant
lastArchivedAtstring (date-time)
lastUnarchivedAtstring (date-time)
categoryOneIdinteger
categoryTwoIdinteger
categoryThreeIdinteger
contentUpdatedAtstring (date-time)
lastArchivedAtstring (date-time)
lastUnarchivedAtstring (date-time)
linkedProductVariantsarray[ProductVariantInventoryLink]
idinteger
productVariantIdinteger
inventoryVariantIdinteger (int64)required
scheduledToDeleteAtstring (date-time)
customFieldsarray[InventoryVariantCustomField]
idinteger (int64)
customFieldValueIdinteger
customFieldIdinteger
namestringrequired
valuestringrequired
originalInventoryNamestring
originalInventoryValuestring
mergeToCustomFieldIdinteger
mergeToCustomFieldNamestring
mergeToCustomFieldValueIdinteger
mergeToCustomFieldValuestring
allowBackordersboolean
binLocationstring
An identifier representing the location of a bin in an internal warehouse
descriptionstring
contentUpdatedAtstring (date-time)
requiresFflboolean
Indicate if FFL information will be required to fulfill this inventory variant
lastArchivedAtstring (date-time)
lastUnarchivedAtstring (date-time)
categoryOneIdinteger
categoryTwoIdinteger
categoryThreeIdinteger
contentUpdatedAtstring (date-time)
lastArchivedAtstring (date-time)
lastUnarchivedAtstring (date-time)
linkedProductVariantsarray[ProductVariantInventoryLink]
idinteger
productVariantIdinteger
inventoryVariantIdinteger (int64)required
scheduledToDeleteAtstring (date-time)
customFieldsarray[InventoryVariantCustomField]
idinteger (int64)
customFieldValueIdinteger
customFieldIdinteger
namestringrequired
valuestringrequired
originalInventoryNamestring
originalInventoryValuestring
mergeToCustomFieldIdinteger
mergeToCustomFieldNamestring
mergeToCustomFieldValueIdinteger
mergeToCustomFieldValuestring
allowBackordersboolean
binLocationstring
An identifier representing the location of a bin in an internal warehouse
descriptionstring
contentUpdatedAtstring (date-time)
requiresFflboolean
Indicate if FFL information will be required to fulfill this inventory variant
lastArchivedAtstring (date-time)
lastUnarchivedAtstring (date-time)
Example response
{
  "sourceId": 0,
  "inventoryParentId": 0,
  "supplierVariantId": "string",
  "shippingCost": 0,
  "dropshipFee": 0,
  "inventoryListPrice": 0,
  "referenceIdentifier": "string",
  "inventoryVariantId": "string",
  "committedQuantity": 0,
  "incomingQuantity": 0,
  "quantity": 0,
  "totalQuantity": 0,
  "id": 0,
  "accountId": 0,
  "sku": "string",
  "title": "string",
  "mpn": "string",
  "masterSku": "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",
  "totalQuantityLastChangedAt": "2026-04-20T00:00:00Z",
  "archived": true,
  "cost": 0,
  "weightUnit": {
    "handle": "pound",
    "abbreviatedHandle": "lb"
  },
  "dimensionUnit": {
    "handle": "inch",
    "abbreviatedHandle": "in"
  },
  "dimensionalWeight": 0,
  "images": [
    {
      "id": 0,
      "sourceId": 0,
      "inventoryParentId": 0,
      "inventoryVariantId": 0,
      "hash": "string",
      "originalUrl": "string",
      "url": "string",
      "sortOrder": 0
    }
  ],
  "options": [
    {
      "inventoryParentOptionId": 0,
      "inventoryVariantId": 0,
      "id": 0,
      "name": "string",
      "value": "string"
    }
  ],
  "customAggregateFields": [
    {
      "id": 0,
      "sourceVariantId": 0,
      "accountId": 0,
      "customAggregateField": {
        "id": 0,
        "aggregateFieldDataTypeId": 0,
        "customAggregateFieldOptionId": 0,
        "name": "string",
        "handle": "string",
        "ignoreOutOfStock": true,
        "accountId": 0
      },
      "name": "string",
      "value": 0,
      "customAggregateFieldId": 0
    }
  ],
  "parent": {
    "sourceId": 0,
    "restricted": true,
    "variantCount": 0,
    "id": 0,
    "accountId": 0,
    "sku": "string",
    "title": "string",
    "description": "string",
    "manufacturer": "string",
    "insertedAt": "2026-04-20T00:00:00Z",
    "updatedAt": "2026-04-20T00:00:00Z",
    "archived": true,
    "categoryOne": {
      "sourceId": 0,
      "productCategoryId": 0,
      "id": 0,
      "name": "string",
      "excluded": true,
      "parentCategoryId": 0
    },
    "categoryTwo": {
      "sourceId": 0,
      "productCategoryId": 0,
      "id": 0,
      "name": "string",
      "excluded": true,
      "parentCategoryId": 0
    },
    "categoryThree": {
      "sourceId": 0,
      "productCategoryId": 0,
      "id": 0,
      "name": "string",
      "excluded": true,
      "parentCategoryId": 0
    },
    "images": [
      {
        "id": 0,
        "sourceId": 0,
        "inventoryParentId": 0,
        "inventoryVariantId": 0,
        "hash": "string",
        "originalUrl": "string",
        "url": "string",
        "sortOrder": 0
      }
    ],
    "options": [
      {
        "inventoryParentId": 0,
        "id": 0,
        "name": "string"
      }
    ],
    "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": [
      {
        "sourceId": 0,
        "inventoryParentId": 0,
        "supplierVariantId": "string",
        "shippingCost": 0,
        "dropshipFee": 0,
        "inventoryListPrice": 0,
        "referenceIdentifier": "string",
        "inventoryVariantId": "string",
        "committedQuantity": 0,
        "incomingQuantity": 0,
        "quantity": 0,
        "totalQuantity": 0,
        "id": 0,
        "accountId": 0,
        "sku": "string",
        "title": "string",
        "mpn": "string",
        "masterSku": "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",
        "totalQuantityLastChangedAt": "2026-04-20T00:00:00Z",
        "archived": true,
        "cost": 0,
        "weightUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "dimensionUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "dimensionalWeight": 0,
        "images": [
          null
        ],
        "options": [
          null
        ],
        "customAggregateFields": [
          null
        ],
        "parent": {
          "sourceId": null,
          "restricted": null,
          "variantCount": null,
          "id": null,
          "accountId": 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,
          "contentUpdatedAt": null,
          "lastArchivedAt": null,
          "lastUnarchivedAt": null
        },
        "linkedProductVariants": [
          null
        ],
        "scheduledToDeleteAt": "2026-04-20T00:00:00Z",
        "customFields": [
          null
        ],
        "allowBackorders": true,
        "binLocation": "string",
        "description": "string",
        "contentUpdatedAt": "2026-04-20T00:00:00Z",
        "requiresFfl": true,
        "lastArchivedAt": "2026-04-20T00:00:00Z",
        "lastUnarchivedAt": "2026-04-20T00:00:00Z"
      }
    ],
    "categoryOneId": 0,
    "categoryTwoId": 0,
    "categoryThreeId": 0,
    "contentUpdatedAt": "2026-04-20T00:00:00Z",
    "lastArchivedAt": "2026-04-20T00:00:00Z",
    "lastUnarchivedAt": "2026-04-20T00:00:00Z"
  },
  "linkedProductVariants": [
    {
      "id": 0,
      "productVariantId": 0,
      "inventoryVariantId": 0
    }
  ],
  "scheduledToDeleteAt": "2026-04-20T00:00:00Z",
  "customFields": [
    {
      "id": 0,
      "customFieldValueId": 0,
      "customFieldId": 0,
      "name": "string",
      "value": "string",
      "originalInventoryName": "string",
      "originalInventoryValue": "string",
      "mergeToCustomFieldId": 0,
      "mergeToCustomFieldName": "string",
      "mergeToCustomFieldValueId": 0,
      "mergeToCustomFieldValue": "string"
    }
  ],
  "allowBackorders": true,
  "binLocation": "string",
  "description": "string",
  "contentUpdatedAt": "2026-04-20T00:00:00Z",
  "requiresFfl": true,
  "lastArchivedAt": "2026-04-20T00:00:00Z",
  "lastUnarchivedAt": "2026-04-20T00:00:00Z"
}
401Unauthorized

No schema documented for this status.

404Not Found

No schema documented for this status.

OpenAPI fragment
{
  "get": {
    "summary": "Get Inventory Variant",
    "parameters": [
      {
        "schema": {
          "type": "boolean",
          "default": false
        },
        "in": "query",
        "name": "includeParent",
        "description": "If \"true\" is passed, the \"parent\" node will be populated with Parent information. NOTE : The \"variants\" will be empty in this node to prevent circular references."
      },
      {
        "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. "
      },
      {
        "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. "
      },
      {
        "schema": {
          "type": "boolean",
          "default": true
        },
        "in": "query",
        "name": "includeLinkedProductVariants",
        "description": "If \"false\" is passed, the \"linkedProductVariants\" node will not be populated."
      }
    ],
    "responses": {
      "200": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InventoryVariant"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized"
      },
      "404": {
        "description": "Not Found"
      }
    }
  }
}
Ready to run it? Send the curl from your terminal or Postman, or use the interactive tester in Stoplight.Open in Stoplight