Global Retailer Schema

The Label Insight Global Retailer Schema is the default schema for all Attribute data delivered for international retailers (Non-US) via the Products API or to Label Insight's hosted SFTP.

Data Types

Global Retailer Schema along with the associated data type for each field.

{
  "upc": "String",
  "brand": "String",
  "productTitle": "String",
  "gtinFormats": {
    "upc12NoCheckDigit": "String",
    "gtin14": "String",
    "gtin12": "String"
  },
  "attributes": [
    {
      "name": "String"
    },
    {
      "name": "String"
    },
    {
      "name": "String"
    }
  ],
  "lastUpdatedTimestamp": "IsoTimestamp"
}
{
  "upc": "894936000544",
  "brand": "TUTTI",
  "productTitle": "CHOCOLATE ALMOND & CINNAMON gourmet BISCOTTI",
  "gtinFormats": {
    "upc12NoCheckDigit": "089493600054",
    "gtin14": "00894936000544",
    "gtin12": "894936000544"
  },
  "attributes": [
    {
      "name": "Kosher"
    },
    {
      "name": "Gluten-Free"
    },
    {
      "name": "Made In Canada Stated"
    }
  ],
  "lastUpdatedTimestamp": "2025-02-20T22:22:33.705608Z"
}

Field Documentation

Field NameDescriptionExample
upcThis is the verbatim on package barcode captured for this given product. This field is NOT normalized to adhere to a certain GS1 Code and is strictly transcribed from the packaging image.012345678900
brandThe brand of the product as listed on package.Best Brand
productTitleThis is the identity of the product or the main product description associated with the product label. This field consists of the observed statement of identity, including Flavor when applicable.Strawberry Whole Milk Yogurt
gtinFormats
upc12NoCheckDigit12 digit with no rear check digit001234567890
gtin1212-digit with rear check digit012345678900
gtin1414-digit product identifier which is comprised of three components:
(1) One digit representing the Indicator Digit to indicate packaging level;
(2) Twelve digits containing the GS1 US-Issued GS1 Company Prefix and the Item Reference which is designated internally by the brand/company;
(3) One digit representing the check digit
00123456789000
attributes
nameThe name of the attribute licensed, only appears when the product qualifies for the associated attribute.Organic
lastUpdatedTimestampThe last date which the product data licensed by the Customer in their configuration has experienced an update or change. Please note, Label Insight's update every product weekly and this is not a field that can be leveraged to detect data deltas.2021-02-27T04:51:26.948Z