# GlobalLists

Global lists define reusable object structures that can be referenced on products, variants, categories or within global lists themselves. A global list uses an attribute to define the data model for values in the global list. Using Complex attributes as the data model allows for complex value models for each global list value object.

GET /GlobalLists Get all global lists created in the system

Response status OK (200)

array : GlobalList
GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

PUT /GlobalLists Update a global list

Request parameters

Property name Parameter type Data type Description
globalList body object : GlobalList

Global List model

GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

Response status OK (200)

No body message is returned

POST /GlobalLists Create a new global list

Request parameters

Property name Parameter type Data type Description
globalList body object : GlobalList

Global list model

GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

Response status OK (200)

object

DELETE /GlobalLists Delete a global list

Request parameters

Property name Parameter type Data type Description
uid query string

the Unique id of the global list

Response status OK (200)

No body message is returned

GET /GlobalLists/{uid} Get a specific global list

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list

Response status OK (200)

object : GlobalList
GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

GET /GlobalLists/{uid}/values Get values for a specific global list

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list to get values for

limit query integer

Max number of items to return

afterId query string

Only get values sorted after this id

Response status OK (200)

object : GlobalListValueResultSet
GlobalListValueResultSet
Property name Data type Description
Total integer

Total number of global list values in global list

Remaining integer

Remaining values after the LastId in this result set

LastId string

Last id of values in this resultset. Use as pointer to fetch next batch of values

GlobalListValues array : GlobalListValue

The global list values in this resultset

GlobalListValue
Property name Data type Description
Uid string

Unique id of global list value

SortOrder integer

Sort order of this value compared to other values in the same global list

Value object

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

The table below shows how different attributes translates to this value model.

Attribute type data type
Text attribute string
Number attribute decimal
Boolean attribute bool
Fixedlist attribute value/value[] (depending on whether attribute allows selecting multiple global list values). The datatype of this value model depends on the underlying attribute for the global list of the refernced global list value(s)
Media attribute string/string[] (depending on whether attribute allows selecting multiple medias)
Datetime attribute DateTimeOffset
Category attribute int/int[] (depending on whether attribute allows selecting multiple categories)
Product attribute int/int[] (depending on whether attribute allows selecting multiple products)
Variant attribute int/int[] (depending on whether attribute allows selecting multiple variants)
Collection attribute uuid/uuid[] (depending on whether attribute allows selecting multiple collections)
Attribute attribute string/string[] (depending on whether attribute allows selecting multiple attributes)
Complex attribute object (Each property of the object corresponds to each sub attribute of the complex attribute. The value of each property then corresponds to the data type of that sub attribute)
List attribute value[] (Each value in the array represents each row in the list. The model of each row corresponds to the datatype of the row template set up on the list attribute)

PUT /GlobalLists/{uid}/values Update values in a global list

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list to update values in

globalListValues body array : GlobalListValue

The values to update

GlobalListValue
Property name Data type Description
Uid string

Unique id of global list value

SortOrder integer

Sort order of this value compared to other values in the same global list

Value object

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

The table below shows how different attributes translates to this value model.

Attribute type data type
Text attribute string
Number attribute decimal
Boolean attribute bool
Fixedlist attribute value/value[] (depending on whether attribute allows selecting multiple global list values). The datatype of this value model depends on the underlying attribute for the global list of the refernced global list value(s)
Media attribute string/string[] (depending on whether attribute allows selecting multiple medias)
Datetime attribute DateTimeOffset
Category attribute int/int[] (depending on whether attribute allows selecting multiple categories)
Product attribute int/int[] (depending on whether attribute allows selecting multiple products)
Variant attribute int/int[] (depending on whether attribute allows selecting multiple variants)
Collection attribute uuid/uuid[] (depending on whether attribute allows selecting multiple collections)
Attribute attribute string/string[] (depending on whether attribute allows selecting multiple attributes)
Complex attribute object (Each property of the object corresponds to each sub attribute of the complex attribute. The value of each property then corresponds to the data type of that sub attribute)
List attribute value[] (Each value in the array represents each row in the list. The model of each row corresponds to the datatype of the row template set up on the list attribute)

Response status OK (200)

No body message is returned

POST /GlobalLists/{uid}/values Create values in a global list

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list to create values in

globalListValues body array : GlobalListValue

Values to create in global list

GlobalListValue
Property name Data type Description
Uid string

Unique id of global list value

SortOrder integer

Sort order of this value compared to other values in the same global list

Value object

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

The table below shows how different attributes translates to this value model.

Attribute type data type
Text attribute string
Number attribute decimal
Boolean attribute bool
Fixedlist attribute value/value[] (depending on whether attribute allows selecting multiple global list values). The datatype of this value model depends on the underlying attribute for the global list of the refernced global list value(s)
Media attribute string/string[] (depending on whether attribute allows selecting multiple medias)
Datetime attribute DateTimeOffset
Category attribute int/int[] (depending on whether attribute allows selecting multiple categories)
Product attribute int/int[] (depending on whether attribute allows selecting multiple products)
Variant attribute int/int[] (depending on whether attribute allows selecting multiple variants)
Collection attribute uuid/uuid[] (depending on whether attribute allows selecting multiple collections)
Attribute attribute string/string[] (depending on whether attribute allows selecting multiple attributes)
Complex attribute object (Each property of the object corresponds to each sub attribute of the complex attribute. The value of each property then corresponds to the data type of that sub attribute)
List attribute value[] (Each value in the array represents each row in the list. The model of each row corresponds to the datatype of the row template set up on the list attribute)

Response status OK (200)

No body message is returned

POST /GlobalLists/batch Get a batch of global lists

Request parameters

Property name Parameter type Data type Description
uids body array : string

Array with unique ids of global lists to return

Response status OK (200)

array : GlobalList
GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

GET /GlobalLists/ByAlias/{alias} Get a specific global list by its alias

Request parameters

Property name Parameter type Data type Description
alias path string

Alias of the global list to return

Response status OK (200)

object : GlobalList
GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

POST /GlobalLists/ByAlias/batch Get a batch of global lists by their aliases

Request parameters

Property name Parameter type Data type Description
aliases body array : string

Array of aliases

Response status OK (200)

array : GlobalList
GlobalList
Property name Data type Description
Id integer

Id of global list (readonly)

Uid string

Unique id of global list

Attribute object : Attribute

Attribute defining the data model for values of the global list

ViewRequiresPermission boolean

Indicates whether a special permission is required to view the global list

ViewPermission string

Permission required to view the global list, if ViewRequiresPermission is set

ManageRequiresPermission boolean

Indicates whether a special permission is required in order to create or update values in the global list

CreateRequiresPermission boolean

Indicates whether a special permission is required in order to create values in the global list

EditRequiresPermission boolean

Indicates whether a special permission is required in order to update values in the global list

DeleteRequiresPermission boolean

Indicates whether a special permission is required in order to delete values in the global list

ManagePermission string

Permission required to create or update values in the global list, if ManageRequiresPermission is set

CreatePermission string

Permission required to create values in the global list, if CreateRequiresPermission is set

EditPermission string

Permission required to update values in the global list, if EditRequiresPermission is set

DeletePermission string

Permission required to delete values in the global list, if DeleteRequiresPermission is set

FolderUid string

Uid of folder to place global list in

RequiresSorting boolean

Defines if values on a global list values should be sorted on creation

GlobalListKeys array

Defines data elements of the global list, which in combination must be unique across all values of the this global list (format: [rootAttributeUid][subAttributeUid][LanguageId/NA]_[DimensionSegmentUid/NA] - ex. 17ca35af-9cb9-44a2-a2f4-1d30a3617e01_2ee6ac86-77d0-4385-94b7-84dd59e05d0b_NA_NA)

KeyIsCaseInsensitive boolean

Defines if key value for a global list value is case insensitive

Attribute
This model is an abstract type and can attain any of the below concrete models. The AttributeType property is used to define the actual model type
AttributeReferenceAttribute
BooleanAttribute
CategoryReferenceAttribute
CollectionReferenceAttribute
ComplexAttribute
DateTimeAttribute
FixedListAttribute
ListAttribute
MediaAttribute
NumberAttribute
ProductReferenceAttribute
TextAttribute
VariantGroupReferenceAttribute
VariantReferenceAttribute

GET /GlobalLists/folders Get all global list folders in the system

Response status OK (200)

array : GlobalListFolder
GlobalListFolder
Property name Data type Description
Uid string

Unique id of folder

Name string

Presented name of folder in backoffice


PUT /GlobalLists/folders Update existing global list folder

Request parameters

Property name Parameter type Data type Description
folder body object : GlobalListFolder

Folder model

GlobalListFolder
Property name Data type Description
Uid string

Unique id of folder

Name string

Presented name of folder in backoffice

Response status OK (200)

No body message is returned

POST /GlobalLists/folders Create new global list folder

Request parameters

Property name Parameter type Data type Description
folder body object : GlobalListFolder

Folder model

GlobalListFolder
Property name Data type Description
Uid string

Unique id of folder

Name string

Presented name of folder in backoffice

Response status OK (200)

object

DELETE /GlobalLists/folders Deletes the global list folder with the specified uid

Request parameters

Property name Parameter type Data type Description
uid query string

Uid of folder to delete

Response status OK (200)

No body message is returned

GET /GlobalLists/folders/{uid} Get a specific global list folder

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of folder

Response status OK (200)

object : GlobalListFolder
GlobalListFolder
Property name Data type Description
Uid string

Unique id of folder

Name string

Presented name of folder in backoffice


GET /GlobalLists/queryablefields/{uid} Get available query fields for a specific global list

Request parameters

Property name Parameter type Data type Description
uid path string

Uid of global list

Response status OK (200)

array : QueryableField
QueryableField
Property name Data type Description
Uid string

Unique id of field in PIM

Name string

The display name of the field

SupportsSorting boolean

If true field can be used for sorting


POST /GlobalLists/search/{uid} Get uids of global list values matching certain criteria

Request parameters

Property name Parameter type Data type Description
uid path string

Uid of global list to search

model body object : QueryModel

Query model

QueryModel
This model is an abstract type and can attain any of the below concrete models. The QueryModelType property is used to define the actual model type
SimpleQueryModel
BooleanQueryModel
FieldFilterModel
Property name Data type Description
FieldUid string

Uid of field to query

QueryOperator string

Operator to use for query. Can be any of:

  • Equals / 0 (Value must start with FilterValue)
  • WildcardEquals / 1 (Value must be smaller than FilterValue)
  • SmallerThan / 2 (Value must be smaller than FilterValue)
  • LargerThan / 3 (Value must be larger than FilterValue)
  • IsEmpty / 4 (Value must be empty)
  • IsNotEmpty / 5 (Value must not be empty)
  • Contains / 6 (Value must contain FilterValue)
  • NotContains / 7 (Value must not contain FilterValue)
  • NotEquals / 8 (Value must not be exactly equal to FilterValue (not considering casing))
  • NotWildcardEquals / 9 (Value must not start with FilterValue)
  • InList / 10 (Item field value must match any of the in provided values in FilterList)
FilterValue object

Value to filter for using the QueryOperator. When QueryOperator is "InList", FilterValue must be an array of values to query for

Response status OK (200)

array : string

DELETE /GlobalLists/values Delete a range of global list values

Request parameters

Property name Parameter type Data type Description
valueUids body array : string

Unique ids of values to delete

Response status OK (200)

No body message is returned

GET /GlobalLists/values/{uid} Get a global list value

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list value

Response status OK (200)

object : GlobalListValue
GlobalListValue
Property name Data type Description
Uid string

Unique id of global list value

SortOrder integer

Sort order of this value compared to other values in the same global list

Value object

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

The table below shows how different attributes translates to this value model.

Attribute type data type
Text attribute string
Number attribute decimal
Boolean attribute bool
Fixedlist attribute value/value[] (depending on whether attribute allows selecting multiple global list values). The datatype of this value model depends on the underlying attribute for the global list of the refernced global list value(s)
Media attribute string/string[] (depending on whether attribute allows selecting multiple medias)
Datetime attribute DateTimeOffset
Category attribute int/int[] (depending on whether attribute allows selecting multiple categories)
Product attribute int/int[] (depending on whether attribute allows selecting multiple products)
Variant attribute int/int[] (depending on whether attribute allows selecting multiple variants)
Collection attribute uuid/uuid[] (depending on whether attribute allows selecting multiple collections)
Attribute attribute string/string[] (depending on whether attribute allows selecting multiple attributes)
Complex attribute object (Each property of the object corresponds to each sub attribute of the complex attribute. The value of each property then corresponds to the data type of that sub attribute)
List attribute value[] (Each value in the array represents each row in the list. The model of each row corresponds to the datatype of the row template set up on the list attribute)

GET /GlobalLists/values/{uid}/references Get references to a global list value

#Available from v.3.5.0

Request parameters

Property name Parameter type Data type Description
uid path string

Unique id of global list value

Response status OK (200)

object : GlobalListValueReferences
GlobalListValueReferences
Property name Data type Description
GlobalListValueUid string

Uid of the referenced global list value

ReferencingCategories array : EntityReferenceDetail

List of categories referencing this global list value

ReferencingProducts array : EntityReferenceDetail

List of products referencing this global list value

ReferencingVariantGroups array : EntityReferenceDetail

List of variant groups referencing this global list value

ReferencingVariants array : EntityReferenceDetail

List of variants referencing this global list value

ReferencingGlobalListValues array

List of other global list values referencing this global list value

EntityReferenceDetail
Property name Data type Description
EntityId integer

The id of the referencing entity

AttributeUid string

The attribute on the referencing entity that holds the reference


POST /GlobalLists/values/batch Get a batch of global list values

No more than 5000 values can be requested at a time.

Request parameters

Property name Parameter type Data type Description
valueUids body array : string

Response status OK (200)

array : GlobalListValue
GlobalListValue
Property name Data type Description
Uid string

Unique id of global list value

SortOrder integer

Sort order of this value compared to other values in the same global list

Value object

The value dynamic value model. The data type of this model depends on the Global list attribute setup. If the global list attribute is a Text attribute, this value will be a string If it is a Number attribute, this value will be a decimal and so on.

The table below shows how different attributes translates to this value model.

Attribute type data type
Text attribute string
Number attribute decimal
Boolean attribute bool
Fixedlist attribute value/value[] (depending on whether attribute allows selecting multiple global list values). The datatype of this value model depends on the underlying attribute for the global list of the refernced global list value(s)
Media attribute string/string[] (depending on whether attribute allows selecting multiple medias)
Datetime attribute DateTimeOffset
Category attribute int/int[] (depending on whether attribute allows selecting multiple categories)
Product attribute int/int[] (depending on whether attribute allows selecting multiple products)
Variant attribute int/int[] (depending on whether attribute allows selecting multiple variants)
Collection attribute uuid/uuid[] (depending on whether attribute allows selecting multiple collections)
Attribute attribute string/string[] (depending on whether attribute allows selecting multiple attributes)
Complex attribute object (Each property of the object corresponds to each sub attribute of the complex attribute. The value of each property then corresponds to the data type of that sub attribute)
List attribute value[] (Each value in the array represents each row in the list. The model of each row corresponds to the datatype of the row template set up on the list attribute)

POST /GlobalLists/values/batch/references Get references to a batch of global list values

#Available from v.3.5.0 No more than 5000 values can be requested at a time.

Request parameters

Property name Parameter type Data type Description
uids body array : string

Unique ids of global list values

Response status OK (200)

array : GlobalListValueReferences
GlobalListValueReferences
Property name Data type Description
GlobalListValueUid string

Uid of the referenced global list value

ReferencingCategories array : EntityReferenceDetail

List of categories referencing this global list value

ReferencingProducts array : EntityReferenceDetail

List of products referencing this global list value

ReferencingVariantGroups array : EntityReferenceDetail

List of variant groups referencing this global list value

ReferencingVariants array : EntityReferenceDetail

List of variants referencing this global list value

ReferencingGlobalListValues array

List of other global list values referencing this global list value

EntityReferenceDetail
Property name Data type Description
EntityId integer

The id of the referencing entity

AttributeUid string

The attribute on the referencing entity that holds the reference