Variants | Struct Docs

Get ids of all variants in the system

get

By default, ids for archived variants are not returned

Authorizations

AuthorizationstringRequired

Query parameters

includeArchivedbooleanOptional

Include archived variants

Default: false

Responses

200

OK

application/json

Responseinteger · int32[]

get

/v1/variants/ids

GET /v1/variants/ids HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

Get basic model for a variant

get

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant

Responses

200

OK

application/json

get

/v1/variants/{id}

GET /v1/variants/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Id": 2011,
  "Name": {
    "en-GB": "Apple Iphone - Red/256GB",
    "da-DK": "Apple Iphone - Rød/256GB"
  },
  "ProductId": 3922,
  "SortOrder": 3,
  "VariantGroupId": null,
  "VariantGroupSortOrder": null,
  "Created": "2026-05-03T22:40:49.1287761+01:00",
  "CreatedBy": "Struct",
  "LastModified": "2026-05-03T22:40:49.1287924+01:00",
  "LastModifiedBy": "Struct",
  "IsArchived": false,
  "ArchiveReason": "6bb3ed6f-a5ee-4d61-a025-259ca7f75288",
  "ProductStructureUid": "af6ff348-51ae-47fa-bfc2-3f6e6b68a92b",
  "DefiningAttributes": [
    "aadd339c-6813-4c8f-89a2-100bbd972a03",
    "16293c1d-c3e1-4789-a6ad-abae2a9baa58"
  ],
  "WorkflowStateUid": "68c7cc55-cd96-4989-bc42-5dda2044a286",
  "BusinessUnits": []
}

Delete a variant

delete

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant to delete

Responses

200

OK

No content

delete

/v1/variants/{id}

DELETE /v1/variants/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

No content

Update a variant

patch

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant

Body

Update model containing the updates to make on a variant. Note that properties with null values will be ignored and will not cause an update. This means you should only set properties that shall be updated on the variant

ProductIdinteger · int32 | nullableOptional

Id of product to move variant to

IsArchivedboolean | nullableOptional

Indicate whether the product shall be archived or un-archived

ArchiveReasonstring · uuid | nullableOptional

Reference to the archive reason when archiving variant (if IsArchived is true)

SortOrderinteger · int32 | nullableOptional

Sort order of variant compared to other variants of the product

VariantGroupSortOrderinteger · int32 | nullableOptional

Sort order of variant compared to other variants in same variant group

WorkflowStateUidstring · uuid | nullableOptional

Workflow state to set on the variant

Responses

200

OK

No content

patch

/v1/variants/{id}

PATCH /v1/variants/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 345

{
  "ProductId": null,
  "IsArchived": null,
  "ArchiveReason": "ba48b37d-ee71-4660-9fda-65f2df831b9d",
  "SortOrder": null,
  "VariantGroupSortOrder": null,
  "WorkflowStateUid": "11c9c0f5-c1bd-46bb-982c-d716c97f85b7",
  "BusinessUnits": null,
  "Values": {
    "EAN": "5796359512359",
    "Size": "L",
    "Color": [
      {
        "CultureCode": "en-GB",
        "Data": "Red"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Rød"
      }
    ]
  }
}

200

OK

No content

Get basic model for a range of variants

post

Authorizations

AuthorizationstringRequired

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

application/json

post

/v1/variants/batch

POST /v1/variants/batch HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

[
  {
    "Id": 2011,
    "Name": {
      "en-GB": "Apple Iphone - Red/256GB",
      "da-DK": "Apple Iphone - Rød/256GB"
    },
    "ProductId": 3922,
    "SortOrder": 3,
    "VariantGroupId": null,
    "VariantGroupSortOrder": null,
    "Created": "2026-05-03T22:40:49.1323909+01:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-05-03T22:40:49.1323993+01:00",
    "LastModifiedBy": "Struct",
    "IsArchived": false,
    "ArchiveReason": "8059911f-880a-45d9-b820-c935ded9fb05",
    "ProductStructureUid": "09863674-e5d8-4548-af75-e5e6ad7abbbc",
    "DefiningAttributes": [
      "16e148cf-150a-4181-bd4e-4fada4e3b3b0",
      "f8e4d3da-101d-40de-ad9a-6d007939a72b"
    ],
    "WorkflowStateUid": "a64124a6-b7c9-4f97-bffe-79b980346289",
    "BusinessUnits": []
  },
  {
    "Id": 2012,
    "Name": {
      "en-GB": "Apple Iphone - Red/512GB",
      "da-DK": "Apple Iphone - Rød/512GB"
    },
    "ProductId": 3922,
    "SortOrder": 2,
    "VariantGroupId": null,
    "VariantGroupSortOrder": null,
    "Created": "2026-01-23T22:40:49.1324049+01:00",
    "CreatedBy": "Struct",
    "LastModified": "2025-12-04T22:40:49.1324058+01:00",
    "LastModifiedBy": "Struct",
    "IsArchived": false,
    "ArchiveReason": "942969b5-76be-4329-9951-60ac9b89b2d4",
    "ProductStructureUid": "09863674-e5d8-4548-af75-e5e6ad7abbbc",
    "DefiningAttributes": [
      "16e148cf-150a-4181-bd4e-4fada4e3b3b0",
      "f8e4d3da-101d-40de-ad9a-6d007939a72b"
    ],
    "WorkflowStateUid": "52857ad6-22f6-43d4-a6b3-cbbcbdc262cc",
    "BusinessUnits": []
  },
  {
    "Id": 2013,
    "Name": {
      "en-GB": "Samsung TV - 55 inch",
      "da-DK": "Samsung TV - 55 tommer"
    },
    "ProductId": 4443,
    "SortOrder": 1,
    "VariantGroupId": null,
    "VariantGroupSortOrder": null,
    "Created": "2025-11-09T22:40:49.1324087+01:00",
    "CreatedBy": "Struct",
    "LastModified": "2025-11-09T22:40:49.1324097+01:00",
    "LastModifiedBy": "Struct",
    "IsArchived": false,
    "ArchiveReason": "41074a6f-77ae-4497-af04-d3cb8f32f858",
    "ProductStructureUid": "09863674-e5d8-4548-af75-e5e6ad7abbbc",
    "DefiningAttributes": [
      "4af4da93-cda9-4028-8bb0-ab6b12cc3b24"
    ],
    "WorkflowStateUid": "721adaea-4673-4879-9f22-a07427cd495e",
    "BusinessUnits": []
  }
]

Get basic models for variants

get

No more than 5000 variants can be requested at a time. If no limit is provided, the default limit of 1000 will be used. By default, archived variants are not returned

Authorizations

AuthorizationstringRequired

Query parameters

includeArchivedbooleanOptionalDefault: false

limitinteger · int32OptionalDefault: 1000

afterIdinteger · int32Optional

Responses

200

OK

application/json

get

/v1/variants

GET /v1/variants HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Variants": [
    {
      "Id": 2011,
      "Name": {
        "en-GB": "Apple Iphone - Red/256GB",
        "da-DK": "Apple Iphone - Rød/256GB"
      },
      "ProductId": 3922,
      "SortOrder": 3,
      "VariantGroupId": null,
      "VariantGroupSortOrder": null,
      "Created": "2026-05-03T22:40:49.1339470+01:00",
      "CreatedBy": "Struct",
      "LastModified": "2026-05-03T22:40:49.1339509+01:00",
      "LastModifiedBy": "Struct",
      "IsArchived": false,
      "ArchiveReason": "bde83526-d0ec-461f-98af-b93575e5f767",
      "ProductStructureUid": "81d430a4-296a-4633-99af-1cc2a0826836",
      "DefiningAttributes": [
        "1c59f315-4732-49a4-8e2c-c3d75e97d10e",
        "516b8231-66a7-4658-babd-794af4bc631c"
      ],
      "WorkflowStateUid": "1fde74c3-460d-4ffa-a551-07ab4d367b32",
      "BusinessUnits": []
    },
    {
      "Id": 2012,
      "Name": {
        "en-GB": "Apple Iphone - Red/512GB",
        "da-DK": "Apple Iphone - Rød/512GB"
      },
      "ProductId": 3922,
      "SortOrder": 2,
      "VariantGroupId": null,
      "VariantGroupSortOrder": null,
      "Created": "2026-01-23T22:40:49.1339544+01:00",
      "CreatedBy": "Struct",
      "LastModified": "2025-12-04T22:40:49.1339552+01:00",
      "LastModifiedBy": "Struct",
      "IsArchived": false,
      "ArchiveReason": "de382f5e-7cb9-4b3b-9938-02962d9c7a9c",
      "ProductStructureUid": "81d430a4-296a-4633-99af-1cc2a0826836",
      "DefiningAttributes": [
        "1c59f315-4732-49a4-8e2c-c3d75e97d10e",
        "516b8231-66a7-4658-babd-794af4bc631c"
      ],
      "WorkflowStateUid": "e95e700c-1f59-4876-98a0-2bb6a8a8ffe0",
      "BusinessUnits": []
    },
    {
      "Id": 2013,
      "Name": {
        "en-GB": "Samsung TV - 55 inch",
        "da-DK": "Samsung TV - 55 tommer"
      },
      "ProductId": 4443,
      "SortOrder": 1,
      "VariantGroupId": null,
      "VariantGroupSortOrder": null,
      "Created": "2025-11-09T22:40:49.1339573+01:00",
      "CreatedBy": "Struct",
      "LastModified": "2025-11-09T22:40:49.1339581+01:00",
      "LastModifiedBy": "Struct",
      "IsArchived": false,
      "ArchiveReason": "9ef00148-1f43-4164-b62b-afc13431a1c6",
      "ProductStructureUid": "81d430a4-296a-4633-99af-1cc2a0826836",
      "DefiningAttributes": [
        "67a41564-a22d-461a-9d67-6afa7a2d1ceb"
      ],
      "WorkflowStateUid": "de6dc743-c39b-464a-9985-58f090b7924d",
      "BusinessUnits": []
    }
  ],
  "Total": 20102,
  "Remaining": 20100,
  "LastId": 20
}

Create new variants

post

A maximum of 5000 variants can be created in one request

Authorizations

AuthorizationstringRequired

Bodyobject[]

Model for creating a new variant

ProductIdinteger · int32Optional

Id of product to attach variant to

SortOrderinteger · int32 | nullableOptional

Sort order of variant compared to other variants of the product (when null, variant is placed after existing variants)

VariantGroupSortOrderinteger · int32 | nullableOptional

Sort order of variant compared to other variants in same variant group

WorkflowStateUidstring · uuid | nullableOptional

Workflow state to set on the variant

Responses

200

OK

application/json

Responseinteger · int32

400

Bad Request

application/json

post

/v1/variants

POST /v1/variants HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 547

[
  {
    "ProductId": 3699,
    "SortOrder": null,
    "VariantGroupSortOrder": null,
    "WorkflowStateUid": "3ffbc8ac-1dd8-46ed-997b-34f0c952f6ad",
    "BusinessUnits": null,
    "Values": {
      "EAN": "5796359512359",
      "Size": "L",
      "Color": [
        {
          "CultureCode": "en-GB",
          "Data": "Red"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Rød"
        }
      ]
    }
  },
  {
    "ProductId": 3699,
    "SortOrder": null,
    "VariantGroupSortOrder": null,
    "WorkflowStateUid": "83bc8dda-b190-412a-9654-29383d887461",
    "BusinessUnits": null,
    "Values": {
      "EAN": "5756962549623",
      "Size": "M",
      "Color": [
        {
          "CultureCode": "en-GB",
          "Data": "Red"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Rød"
        }
      ]
    }
  }
]

Delete multiple variants

delete

Authorizations

AuthorizationstringRequired

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

No content

delete

/v1/variants

DELETE /v1/variants HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

No content

Update multiple variants

patch

Authorizations

AuthorizationstringRequired

Bodyobject[]

Update model for a variant

VariantIdinteger · int32Optional

Id of variant to update

Responses

200

OK

No content

patch

/v1/variants

PATCH /v1/variants HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 831

[
  {
    "VariantId": 23556,
    "UpdateModel": {
      "ProductId": null,
      "IsArchived": null,
      "ArchiveReason": "e70578c3-61ed-45e0-b66e-bd836703025d",
      "SortOrder": null,
      "VariantGroupSortOrder": null,
      "WorkflowStateUid": "b05a3a02-c4da-4ba8-b980-a2a0e97f1aaf",
      "BusinessUnits": null,
      "Values": {
        "Size": "L"
      }
    }
  },
  {
    "VariantId": 20111,
    "UpdateModel": {
      "ProductId": null,
      "IsArchived": true,
      "ArchiveReason": "384043af-d284-4a88-957f-126b05feb474",
      "SortOrder": null,
      "VariantGroupSortOrder": null,
      "WorkflowStateUid": "46198d1b-6339-4a8e-be9d-9ee0d24ac1ee",
      "BusinessUnits": null,
      "Values": {}
    }
  },
  {
    "VariantId": 56843,
    "UpdateModel": {
      "ProductId": 30211,
      "IsArchived": null,
      "ArchiveReason": "5a2d4db6-5a17-446d-bd86-518c3d46aa73",
      "SortOrder": 32,
      "VariantGroupSortOrder": null,
      "WorkflowStateUid": "9a19c506-6d42-44a8-8858-6aa2cf40adb0",
      "BusinessUnits": null,
      "Values": {
        "EAN": "5796359512359",
        "Size": "M"
      }
    }
  }
]

200

OK

No content

Get all identifiers and their internal ids for a specific identifier type

get

Authorizations

AuthorizationstringRequired

Path parameters

identifierAliasstringRequired

Alias of identifier type

Responses

200

OK

application/json

get

/v1/variants/identifiers/{identifierAlias}

GET /v1/variants/identifiers/{identifierAlias} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "5796359512359": 10000,
  "5756525697563": 11012,
  "5756326985442": 15133
}

Get the internal id of a variant based on its identifier

get

Authorizations

AuthorizationstringRequired

Path parameters

identifierAliasstringRequired

Alias of identifier type

identifierstringRequired

Identifier value

Responses

200

OK

application/json

Responseinteger · int32

get

/v1/variants/identifiers/{identifierAlias}/{identifier}

GET /v1/variants/identifiers/{identifierAlias}/{identifier} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

Get internal ids of multiple variants from their identifier

post

Authorizations

AuthorizationstringRequired

Body

Provide an identifier alias along with an array of identifiers to get the internal entity ids matching those identifiers

IdentifierAliasstring | nullableOptional

The alias of the identifier

Identifiersstring[] | nullableOptional

Array of identifiers to return internal ids for

Responses

200

OK

application/json

post

/v1/variants/batch/identifiers

POST /v1/variants/batch/identifiers HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "IdentifierAlias": "text",
  "Identifiers": [
    "text"
  ]
}

200

OK

{
  "5796359512359": 10000,
  "5756525697563": 11012,
  "5756326985442": 15133,
  "5799645384354": null
}

Get attribute values for a variant

get

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant

Query parameters

globalListValueReferencesOnlybooleanOptional

Indicate if only uids of referenced to global list values shall be returned instead of the materialized values

Default: false

Responses

200

OK

application/json

404

Not Found

application/json

get

/v1/variants/{id}/attributevalues

GET /v1/variants/{id}/attributevalues HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "VariantId": 56687,
  "Values": {
    "EAN": "5796359512359",
    "Size": "L",
    "Color": [
      {
        "CultureCode": "en-GB",
        "Data": "Red"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Rød"
      }
    ]
  }
}

Get attribute values for multiple variants

post

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

Authorizations

AuthorizationstringRequired

Body

Define which categories to fetch data for and what data to fetch

VariantIdsinteger · int32[] | nullableOptional

Ids of products to return

IncludeValuesinteger · enumOptional

Defines which attribute values to return

1 = All: Return all attribute values
2 = Scopes: Return values for scopes specified in request
3 = Aliases: Return values for attribute aliases specified in request
4 = ScopesAndAliases: Return values for attributes in specified scopes, plus values in the attributes specified by alias
5 = Uids: Return values for attribute uids specified in request

Possible values:

Scopesstring[] | nullableOptional

If IncludeValues is Scopes, define which scopes to return values for here

Aliasesstring[] | nullableOptional

If IncludeValues is Aliases, define aliases of the attributes to include values for

Uidsstring · uuid[] | nullableOptional

If IncludeValues is Uids, define uids of the attributes to include values for

LimitToCultureCodesstring[] | nullableOptional

Only return values for specific languages

LimitToSegmentsstring[] | nullableOptional

Only return values for specific dimension segments

GlobalListValueReferencesOnlybooleanOptional

Indicate if only uids of referenced to global list values shall be returned instead of the materialized values

FromTimestampstring · date-time | nullableOptional

Get attribute values back in time

Responses

200

OK

application/json

post

/v1/variants/batch/attributevalues

POST /v1/variants/batch/attributevalues HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 259

{
  "VariantIds": [
    1
  ],
  "IncludeValues": 1,
  "Scopes": [
    "text"
  ],
  "Aliases": [
    "text"
  ],
  "Uids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "LimitToCultureCodes": [
    "text"
  ],
  "LimitToSegments": [
    "text"
  ],
  "GlobalListValueReferencesOnly": true,
  "FromTimestamp": "2025-12-08T09:38:36.121Z"
}

200

OK

[
  {
    "VariantId": 56687,
    "Values": {
      "EAN": "5796359512359",
      "Size": "L",
      "Color": [
        {
          "CultureCode": "en-GB",
          "Data": "Red"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Rød"
        }
      ]
    }
  },
  {
    "VariantId": 56297,
    "Values": {
      "EAN": "5756962549623",
      "Size": "M",
      "Color": [
        {
          "CultureCode": "en-GB",
          "Data": "Red"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Rød"
        }
      ]
    }
  }
]

Get references to a variant

get

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant

Responses

200

OK

application/json

get

/v1/variants/{id}/references

GET /v1/variants/{id}/references HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "VariantId": 12,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "16a9ace9-75cd-4875-a5bf-bcef795bdd86"
      },
      {
        "EntityId": 101,
        "AttributeUid": "16a9ace9-75cd-4875-a5bf-bcef795bdd86"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 100010,
        "AttributeUid": "011c4e78-f3d1-488f-a63d-1870686c73bf"
      },
      {
        "EntityId": 100011,
        "AttributeUid": "011c4e78-f3d1-488f-a63d-1870686c73bf"
      },
      {
        "EntityId": 102354,
        "AttributeUid": "9b6024a7-1200-4fb1-bf62-468ddfe5b3ad"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 100,
        "AttributeUid": "011c4e78-f3d1-488f-a63d-1870686c73bf"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "660abd95-49c8-46a3-88c7-557eb0841bb6",
      "58ac6a38-7471-4533-876f-94ff9828cd44"
    ]
  },
  {
    "VariantId": 20,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "16a9ace9-75cd-4875-a5bf-bcef795bdd86"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 23553,
        "AttributeUid": "011c4e78-f3d1-488f-a63d-1870686c73bf"
      },
      {
        "EntityId": 5656,
        "AttributeUid": "011c4e78-f3d1-488f-a63d-1870686c73bf"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 568323,
        "AttributeUid": "9b6024a7-1200-4fb1-bf62-468ddfe5b3ad"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "e67d1c05-f13e-4945-aed8-7da4b4fd7b76",
      "a63f1cc1-3cd6-4dc7-a157-33827943b09c"
    ]
  }
]

Get references to a batch of variants

post

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

Authorizations

AuthorizationstringRequired

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

application/json

post

/v1/variants/batch/references

POST /v1/variants/batch/references HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

[
  {
    "VariantId": 12,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "262e3ee5-e398-4310-8a5f-3a8cdcf71abd"
      },
      {
        "EntityId": 101,
        "AttributeUid": "262e3ee5-e398-4310-8a5f-3a8cdcf71abd"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 100010,
        "AttributeUid": "1e1b96eb-4627-4f02-b532-a19549e54bb2"
      },
      {
        "EntityId": 100011,
        "AttributeUid": "1e1b96eb-4627-4f02-b532-a19549e54bb2"
      },
      {
        "EntityId": 102354,
        "AttributeUid": "6fb5617b-d494-4f78-83cb-efd055cfca67"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 100,
        "AttributeUid": "1e1b96eb-4627-4f02-b532-a19549e54bb2"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "fad07838-d436-48d5-97b0-a1e1bd2ea1db",
      "510ab4ff-7b65-4978-b6bd-2792eadd14ab"
    ]
  },
  {
    "VariantId": 20,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "262e3ee5-e398-4310-8a5f-3a8cdcf71abd"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 23553,
        "AttributeUid": "1e1b96eb-4627-4f02-b532-a19549e54bb2"
      },
      {
        "EntityId": 5656,
        "AttributeUid": "1e1b96eb-4627-4f02-b532-a19549e54bb2"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 568323,
        "AttributeUid": "6fb5617b-d494-4f78-83cb-efd055cfca67"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "b116ad14-92fd-4149-b81c-ab2bc7fb4b0e",
      "50be15bf-90ed-4912-adc8-b5c8a5966554"
    ]
  }
]

Get ids of variants matching certain criteria

post

Authorizations

AuthorizationstringRequired

Body

Search model used for searching products or variants in PIM

IncludeArchivedbooleanOptional

Include archived items in result

Responses

200

OK

application/json

Responseinteger · int32[]

post

/v1/variants/search

POST /v1/variants/search HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 503

{
  "IncludeArchived": false,
  "QueryModel": {
    "SubQueries": [
      {
        "Filters": [
          {
            "FieldUid": "ReleasedInCountries_NA_NA",
            "QueryOperator": {},
            "FilterValue": "DK"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      },
      {
        "Filters": [
          {
            "FieldUid": "Color.BaseColor.Name_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "red"
          },
          {
            "FieldUid": "Color.BaseColor.Name_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "blue"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      }
    ],
    "BooleanOperator": {},
    "QueryModelType": "BooleanQueryModel"
  }
}

200

OK

Get paged result of variants matching certain criteria. Result mapped with headers and item results

post

Authorizations

AuthorizationstringRequired

Body

Extended search model used for searching products or variants in PIM with support for paging and sorting

Pageinteger · int32Optional

PageSizeinteger · int32 | nullableOptional

FieldUidsstring[] | nullableOptional

SortByFieldUidstring | nullableOptional

SortDescendingboolean | nullableOptional

IncludeArchivedbooleanOptional

Include archived items in result

Responses

200

OK

application/json

post

/v1/variants/search/paged

POST /v1/variants/search/paged HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 648

{
  "Page": 1,
  "PageSize": 10,
  "FieldUids": [
    "Id",
    "Color.BaseColor.Name_en-GB_NA"
  ],
  "SortByFieldUid": "Color.BaseColor.Name_en-GB_NA",
  "SortDescending": true,
  "IncludeArchived": false,
  "QueryModel": {
    "SubQueries": [
      {
        "Filters": [
          {
            "FieldUid": "ReleasedInCountries_NA_NA",
            "QueryOperator": {},
            "FilterValue": "DK"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      },
      {
        "Filters": [
          {
            "FieldUid": "Color.BaseColor.Name_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "red"
          },
          {
            "FieldUid": "Color.BaseColor.Name_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "blue"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      }
    ],
    "BooleanOperator": {},
    "QueryModelType": "BooleanQueryModel"
  }
}

200

OK

{
  "TotalHits": 1,
  "Page": 1,
  "PageSize": 1,
  "TotalPages": 1,
  "ItemListHeaders": [
    {
      "FieldUid": "text",
      "FieldName": "text",
      "FieldType": "text",
      "SupportsSearching": true,
      "SupportsSorting": true
    }
  ],
  "ListItems": [
    {
      "Id": 1,
      "ShownValues": [
        "text"
      ]
    }
  ]
}

Get all available query fields in the PIM installation

get

Authorizations

AuthorizationstringRequired

Responses

200

OK

application/json

get

/v1/variants/queryfields

GET /v1/variants/queryfields HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "Uid": "PIM_CategoryIds",
    "Name": "CategoryIds",
    "SupportsSorting": false
  },
  {
    "Uid": "Name_en-GB",
    "Name": "Name (en-GB)",
    "SupportsSorting": false
  },
  {
    "Uid": "Name_da-DK",
    "Name": "Name (da-DK)",
    "SupportsSorting": false
  },
  {
    "Uid": "Description_en-GB",
    "Name": "Description (en-GB)",
    "SupportsSorting": false
  },
  {
    "Uid": "Description_da-DK",
    "Name": "Description (da-DK)",
    "SupportsSorting": false
  }
]

Get Enrichment Insights for a variant

get

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant to get insights for

Responses

200

OK

application/json

get

/v1/variants/{id}/enrichmentinsights

GET /v1/variants/{id}/enrichmentinsights HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "EnrichmentInsightSetupUid": "b9ab083f-d622-4eba-b273-4a9bf26a3a03",
    "EntityId": 1974035,
    "Completeness": 50,
    "MissingData": [
      {
        "Type": "AttributeInsightsDataReference",
        "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
      }
    ],
    "Ignored": false
  },
  {
    "EnrichmentInsightSetupUid": "731a399b-f61c-48d4-b1c0-251a20d7125a",
    "EntityId": 1974035,
    "Completeness": 100,
    "MissingData": [],
    "Ignored": false
  }
]

Get Enrichment Insights for a batch of variants

post

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

application/json

post

/v1/variants/batch/enrichmentinsights

POST /v1/variants/batch/enrichmentinsights HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

[
  {
    "EnrichmentInsightSetupUid": "9618e596-0391-47dd-beb2-b60a8f74aa8e",
    "EntityId": 1974035,
    "Completeness": 50,
    "MissingData": [
      {
        "Type": "AttributeInsightsDataReference",
        "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
      }
    ],
    "Ignored": false
  },
  {
    "EnrichmentInsightSetupUid": "9618e596-0391-47dd-beb2-b60a8f74aa8e",
    "EntityId": 1974043,
    "Completeness": 100,
    "MissingData": [],
    "Ignored": false
  }
]

Get insights for a batch of variants and a specific Enrichment Insight

post

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

enrichmentInsightUidstring · uuidRequired

Uid of enrichment insight to get for batch of variants

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

application/json

Responseinteger · int32

post

/v1/variants/batch/enrichmentinsights/{enrichmentInsightUid}

POST /v1/variants/batch/enrichmentinsights/{enrichmentInsightUid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

[
  {
    "EnrichmentInsightSetupUid": "b506687c-37e0-4c59-bb83-d5b71577584e",
    "EntityId": 1974035,
    "Completeness": 50,
    "MissingData": [
      {
        "Type": "AttributeInsightsDataReference",
        "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
      }
    ],
    "Ignored": false
  },
  {
    "EnrichmentInsightSetupUid": "b506687c-37e0-4c59-bb83-d5b71577584e",
    "EntityId": 1974043,
    "Completeness": 100,
    "MissingData": [],
    "Ignored": false
  }
]

Enable or disable an enrichment insight for a variant

patch

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

idinteger · int32Required

Id of variant

enrichmentInsightSetupUidstring · uuidRequired

Uid of enrichment insight to toggle ignore for

ignorebooleanRequired

Indicate whether to ignore the insight for the given enrichment insight and variant

Responses

200

OK

No content

patch

/v1/variants/{id}/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore}

PATCH /v1/variants/{id}/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

No content

Enable or disable an enrichment insight for a batch of variants

patch

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

enrichmentInsightSetupUidstring · uuidRequired

Uid of enrichment insight to toggle ignore for

ignorebooleanRequired

Indicate whether to ignore the insight for the given enrichment insight and variants

Bodyinteger · int32[]

integer · int32[]Optional

Responses

200

OK

No content

patch

/v1/variants/batch/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore}

PATCH /v1/variants/batch/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]

200

OK

No content

Get attributes which values are inherited from the product

post

A maximum of 1000 products can be requested in one request

Authorizations

AuthorizationstringRequired

Body

Request model for getting inheritedAttributes for a list of products

ProductIdsinteger · int32[] | nullableOptional

The product ids to get inherited attributes for

InheritedAttributesstring · uuid[] | nullableOptional

The attribute uids to get inherited attributes for

Responses

200

OK

application/json

post

/v1/variants/inheritedAttributeValues

POST /v1/variants/inheritedAttributeValues HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "ProductIds": [
    1
  ],
  "InheritedAttributes": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

200

OK

[
  {
    "ProductId": 1,
    "VariantId": 1,
    "InheritedAttributes": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
]