Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Categories

Categories are used to create hierarchical structures within a catalogue.Categories serves as a means for structuring products in meaningful classifications

Get ids of all categories in the system

get

Categories are used to organize products within catalogues. Categories can be nested in a hierarchy structure of any depth. The catalogue data model defines attributes which can hold data for each category. Attributes can be attached to categories in the master catalogue to define a structure of attributes available to products depending on their category placement in the master catalogue.

Authorizations
AuthorizationstringRequired
Responses
200

OK

application/json
integer · int32[]Optional
get/v1/categories/ids
GET /v1/categories/ids HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  10,
  11,
  12,
  13,
  14
]

Get basic models for categories

get

No more than 5000 categories can be requested at a time. If no limit is provided, the default limit of 1000 will be used

Authorizations
AuthorizationstringRequired
Query parameters
limitinteger · int32Optional

Number of categories to return

Default: 1000
afterIdinteger · int32Optional

Only get categories with id larger than this id

Responses
200

OK

application/json

Result set of categories from a category query

Totalinteger · int32Optional

The total number of items

Remaininginteger · int32Optional

The remaining items that lie after the last id of the item in this result set

LastIdinteger · int32Optional

The id of the last item in this result set

get/v1/categories
GET /v1/categories HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "Categories": [
    {
      "Id": 10,
      "ParentId": null,
      "SortOrder": 1,
      "CatalogueUid": "2bd9cd60-d2a4-4bcb-b1ba-049716d07bfe",
      "Created": "2026-04-10T18:51:56.1566453+00:00",
      "CreatedBy": "Struct",
      "LastModified": "2026-04-10T18:51:56.1566461+00:00",
      "LastModifiedBy": "Struct",
      "HasChildren": true,
      "Name": {
        "en-GB": "Electronics",
        "da-DK": "Elektronik"
      },
      "Dynamic": false,
      "QuerySetup": null,
      "WorkflowStateUid": "aadd7045-fab3-4c93-96de-23e6054ba77d",
      "BusinessUnits": []
    },
    {
      "Id": 11,
      "ParentId": null,
      "SortOrder": 2,
      "CatalogueUid": "2bd9cd60-d2a4-4bcb-b1ba-049716d07bfe",
      "Created": "2026-04-10T18:51:56.1566470+00:00",
      "CreatedBy": "Struct",
      "LastModified": "2026-04-10T18:51:56.1566471+00:00",
      "LastModifiedBy": "Struct",
      "HasChildren": true,
      "Name": {
        "en-GB": "Clothing",
        "da-DK": "Tøj"
      },
      "Dynamic": false,
      "QuerySetup": null,
      "WorkflowStateUid": "3062e87f-1bef-4e37-acbd-2ef3eea75967",
      "BusinessUnits": []
    },
    {
      "Id": 12,
      "ParentId": null,
      "SortOrder": 3,
      "CatalogueUid": "2bd9cd60-d2a4-4bcb-b1ba-049716d07bfe",
      "Created": "2026-04-10T18:51:56.1566475+00:00",
      "CreatedBy": "Struct",
      "LastModified": "2026-04-10T18:51:56.1566476+00:00",
      "LastModifiedBy": "Struct",
      "HasChildren": true,
      "Name": {
        "en-GB": "Wine",
        "da-DK": "Vin"
      },
      "Dynamic": false,
      "QuerySetup": null,
      "WorkflowStateUid": "55a3a986-d098-433b-931c-663f898db898",
      "BusinessUnits": []
    }
  ],
  "Total": 223,
  "Remaining": 220,
  "LastId": 12
}

Create new categories

post

A maximum of 5000 categories can be created in one request

Authorizations
AuthorizationstringRequired
Bodyobject · Struct.App.Api.Models.Catalogue.CreateCategoryModel[]

Model for creating a new category

CatalogueUidstring · uuidOptional

Uid of catalogue to add category to

ParentIdinteger · int32 · nullableOptional

Id of parent id to place category underneath (set as null, of category shall be at root level of catalogue)

SortOrderinteger · int32 · nullableOptional

Sort order of category compared to other categories at the same level i the catalogue

Dynamicboolean · nullableOptional

Set if products for this category is found by search query set on category

WorkflowStateUidstring · uuid · nullableOptional

Workflow state to set on the category

Responses
201

Created

application/json
integer · int32[]Optional
post/v1/categories
POST /v1/categories HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1431

[
  {
    "CatalogueUid": "90d3a47e-1252-438f-a839-1bba4fd57017",
    "ParentId": null,
    "SortOrder": 1,
    "Dynamic": null,
    "QuerySetup": null,
    "WorkflowStateUid": "681f22c0-b4eb-4d36-96f9-831f7bbaebbf",
    "BusinessUnits": null,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Elektronik"
        }
      ],
      "HeaderImage": "3013",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor elektronik"
        }
      ]
    }
  },
  {
    "CatalogueUid": "90d3a47e-1252-438f-a839-1bba4fd57017",
    "ParentId": null,
    "SortOrder": 2,
    "Dynamic": null,
    "QuerySetup": null,
    "WorkflowStateUid": "3fc4a793-112f-4299-9d28-1555ff971a5c",
    "BusinessUnits": null,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Tøj"
        }
      ],
      "HeaderImage": "3014",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor tøj"
        }
      ]
    }
  },
  {
    "CatalogueUid": "90d3a47e-1252-438f-a839-1bba4fd57017",
    "ParentId": null,
    "SortOrder": 3,
    "Dynamic": null,
    "QuerySetup": null,
    "WorkflowStateUid": "9addf992-a9cd-4a17-849f-869a8fa7b9d7",
    "BusinessUnits": null,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Vin"
        }
      ],
      "HeaderImage": "3015",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor vin"
        }
      ]
    }
  }
]
[
  1
]

Delete multiple categories

delete
Authorizations
AuthorizationstringRequired
Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

No content
delete/v1/categories
DELETE /v1/categories HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]
200

OK

No content

Update multiple categories

patch

A maximum of 5000 categories can be updated in one request

Authorizations
AuthorizationstringRequired
Body
Responses
200

OK

No content
patch/v1/categories
PATCH /v1/categories HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 817

{
  "10": {
    "SortOrder": 1,
    "MoveCommand": null,
    "QuerySetup": null,
    "WorkflowStateUid": "d0ffd386-d444-40a4-a818-1b0ede3a1924",
    "BusinessUnits": null,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Vin"
        }
      ],
      "HeaderImage": "3015",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor vin"
        }
      ]
    }
  },
  "11": {
    "SortOrder": 2,
    "MoveCommand": null,
    "QuerySetup": null,
    "WorkflowStateUid": "c44f283e-ff75-4013-8cb3-c41d455f752b",
    "BusinessUnits": null,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Tøj"
        }
      ],
      "HeaderImage": "3014",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor tøj"
        }
      ]
    }
  }
}
No content

Get basic model for a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

Responses
200

OK

application/json

Defines general information on a category

Idinteger · int32Optional

Id of category

ParentIdinteger · int32 · nullableOptional

Id of category's parent category. Null, if this category is placed in the root of its catalogue

SortOrderinteger · int32Optional

Sortorder of the category compared to other categories at the same level in the catalogue

CatalogueUidstring · uuidOptional

The unique id of the catalogue, this category resides in

Createdstring · date-timeOptional

Timestamp of the creation of category

CreatedBystring · nullableOptional

Username of user who created this category

LastModifiedstring · date-timeOptional

Timestamp of last modification of category

LastModifiedBystring · nullableOptional

Username of user who did the last modification

HasChildrenbooleanOptional

Indicates whether this category has any sub categories

DynamicbooleanOptional

Indicates whether this category is dynamic (classification handled by PIM)

WorkflowStateUidstring · uuid · nullableOptional

The uid of the workflow state of the category

get/v1/categories/{id}
GET /v1/categories/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "Id": 10,
  "ParentId": null,
  "SortOrder": 1,
  "CatalogueUid": "77f6c219-4901-4239-afa3-25b4aad1f63c",
  "Created": "2026-04-10T18:51:56.1589558+00:00",
  "CreatedBy": "Struct",
  "LastModified": "2026-04-10T18:51:56.1589571+00:00",
  "LastModifiedBy": "Struct",
  "HasChildren": true,
  "Name": {
    "en-GB": "Electronics",
    "da-DK": "Elektronik"
  },
  "Dynamic": false,
  "QuerySetup": null,
  "WorkflowStateUid": "a0202398-e057-45ce-9af5-baa31e3120d5",
  "BusinessUnits": []
}

Delete a category

delete
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to delete

Responses
200

OK

No content
delete/v1/categories/{id}
DELETE /v1/categories/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

Update category

patch
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to update

Body

Model representing a category update

SortOrderinteger · int32 · nullableOptional

Set to update sort order of category compared to other categories at the same level in the catalogue (set as null if you do not want to update this)

WorkflowStateUidstring · uuid · nullableOptional

Workflow state to set on the category

Responses
200

OK

No content
patch/v1/categories/{id}
PATCH /v1/categories/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 397

{
  "SortOrder": 2,
  "MoveCommand": null,
  "QuerySetup": null,
  "WorkflowStateUid": "711308ac-0b3b-43c8-9369-9a67df0d6ad2",
  "BusinessUnits": null,
  "Values": {
    "Name": [
      {
        "CultureCode": "en-GB",
        "Data": "Wine"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Vin"
      }
    ],
    "HeaderImage": "3015",
    "Description": [
      {
        "CultureCode": "en-GB",
        "Data": "See all the latest and greatest wine"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Se alt det nyeste indenfor vin"
      }
    ]
  }
}
200

OK

No content

Get basic model for a batch of categories

post

#Available from v.3.2.0

Authorizations
AuthorizationstringRequired
Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

application/json

Defines general information on a category

Idinteger · int32Optional

Id of category

ParentIdinteger · int32 · nullableOptional

Id of category's parent category. Null, if this category is placed in the root of its catalogue

SortOrderinteger · int32Optional

Sortorder of the category compared to other categories at the same level in the catalogue

CatalogueUidstring · uuidOptional

The unique id of the catalogue, this category resides in

Createdstring · date-timeOptional

Timestamp of the creation of category

CreatedBystring · nullableOptional

Username of user who created this category

LastModifiedstring · date-timeOptional

Timestamp of last modification of category

LastModifiedBystring · nullableOptional

Username of user who did the last modification

HasChildrenbooleanOptional

Indicates whether this category has any sub categories

DynamicbooleanOptional

Indicates whether this category is dynamic (classification handled by PIM)

WorkflowStateUidstring · uuid · nullableOptional

The uid of the workflow state of the category

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

[
  1
]
200

OK

[
  {
    "Id": 10,
    "ParentId": null,
    "SortOrder": 1,
    "CatalogueUid": "da3562ae-262b-4c1b-a227-75da65cafe0b",
    "Created": "2026-04-10T18:51:56.1599007+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1599019+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Electronics",
      "da-DK": "Elektronik"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "bdf4322d-e3ea-47a2-bb57-fab9c73212a5",
    "BusinessUnits": []
  },
  {
    "Id": 11,
    "ParentId": null,
    "SortOrder": 2,
    "CatalogueUid": "da3562ae-262b-4c1b-a227-75da65cafe0b",
    "Created": "2026-04-10T18:51:56.1599029+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1599030+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Clothing",
      "da-DK": "Tøj"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "c55e3b4d-ab11-41f9-b18f-dc5491f3dde3",
    "BusinessUnits": []
  },
  {
    "Id": 12,
    "ParentId": null,
    "SortOrder": 3,
    "CatalogueUid": "da3562ae-262b-4c1b-a227-75da65cafe0b",
    "Created": "2026-04-10T18:51:56.1599033+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1599035+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Wine",
      "da-DK": "Vin"
    },
    "Dynamic": true,
    "QuerySetup": {
      "ProductQuery": {
        "SubQueries": [
          {
            "Filters": [
              {
                "FieldUid": "be987a40-30ea-46a0-b3d4-c033623216cf_NA_NA",
                "QueryOperator": {},
                "FilterValue": ">-30d"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          },
          {
            "Filters": [
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "d671ca19-961e-4fa5-af6b-7ab8d1b967a7"
              },
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "c5e97e8d-687b-4bc8-86e1-3b6c1b5d9c1a"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "BooleanQueryModel"
      },
      "VariantGroupQuery": null
    },
    "WorkflowStateUid": "07e70374-1d9c-42db-9bba-f34252c459ed",
    "BusinessUnits": []
  }
]

Get child categories of a specific category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get children for

Responses
200

OK

application/json

Defines general information on a category

Idinteger · int32Optional

Id of category

ParentIdinteger · int32 · nullableOptional

Id of category's parent category. Null, if this category is placed in the root of its catalogue

SortOrderinteger · int32Optional

Sortorder of the category compared to other categories at the same level in the catalogue

CatalogueUidstring · uuidOptional

The unique id of the catalogue, this category resides in

Createdstring · date-timeOptional

Timestamp of the creation of category

CreatedBystring · nullableOptional

Username of user who created this category

LastModifiedstring · date-timeOptional

Timestamp of last modification of category

LastModifiedBystring · nullableOptional

Username of user who did the last modification

HasChildrenbooleanOptional

Indicates whether this category has any sub categories

DynamicbooleanOptional

Indicates whether this category is dynamic (classification handled by PIM)

WorkflowStateUidstring · uuid · nullableOptional

The uid of the workflow state of the category

get/v1/categories/{id}/children
GET /v1/categories/{id}/children HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "Id": 10,
    "ParentId": null,
    "SortOrder": 1,
    "CatalogueUid": "d7042267-377a-41e9-b1e4-0f889be9882d",
    "Created": "2026-04-10T18:51:56.1602499+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1602507+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Electronics",
      "da-DK": "Elektronik"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "c04115be-c053-460c-8250-76ff5ba6c962",
    "BusinessUnits": []
  },
  {
    "Id": 11,
    "ParentId": null,
    "SortOrder": 2,
    "CatalogueUid": "d7042267-377a-41e9-b1e4-0f889be9882d",
    "Created": "2026-04-10T18:51:56.1602514+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1602515+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Clothing",
      "da-DK": "Tøj"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "b71041a0-ad3c-4293-be24-c3f58b8aebed",
    "BusinessUnits": []
  },
  {
    "Id": 12,
    "ParentId": null,
    "SortOrder": 3,
    "CatalogueUid": "d7042267-377a-41e9-b1e4-0f889be9882d",
    "Created": "2026-04-10T18:51:56.1602519+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1602520+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Wine",
      "da-DK": "Vin"
    },
    "Dynamic": true,
    "QuerySetup": {
      "ProductQuery": {
        "SubQueries": [
          {
            "Filters": [
              {
                "FieldUid": "be987a40-30ea-46a0-b3d4-c033623216cf_NA_NA",
                "QueryOperator": {},
                "FilterValue": ">-30d"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          },
          {
            "Filters": [
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "d671ca19-961e-4fa5-af6b-7ab8d1b967a7"
              },
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "c5e97e8d-687b-4bc8-86e1-3b6c1b5d9c1a"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "BooleanQueryModel"
      },
      "VariantGroupQuery": null
    },
    "WorkflowStateUid": "90f048c1-f44b-4675-ac24-337176526596",
    "BusinessUnits": []
  }
]

Get child categories for a range categories

post
Authorizations
AuthorizationstringRequired
Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

application/json

Defines general information on a category

Idinteger · int32Optional

Id of category

ParentIdinteger · int32 · nullableOptional

Id of category's parent category. Null, if this category is placed in the root of its catalogue

SortOrderinteger · int32Optional

Sortorder of the category compared to other categories at the same level in the catalogue

CatalogueUidstring · uuidOptional

The unique id of the catalogue, this category resides in

Createdstring · date-timeOptional

Timestamp of the creation of category

CreatedBystring · nullableOptional

Username of user who created this category

LastModifiedstring · date-timeOptional

Timestamp of last modification of category

LastModifiedBystring · nullableOptional

Username of user who did the last modification

HasChildrenbooleanOptional

Indicates whether this category has any sub categories

DynamicbooleanOptional

Indicates whether this category is dynamic (classification handled by PIM)

WorkflowStateUidstring · uuid · nullableOptional

The uid of the workflow state of the category

post/v1/categories/batch/children
POST /v1/categories/batch/children HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]
200

OK

[
  {
    "Id": 10,
    "ParentId": 1,
    "SortOrder": 1,
    "CatalogueUid": "245b9772-d981-4d98-a77e-20ecf86112c2",
    "Created": "2026-04-10T18:51:56.1606252+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1606259+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Electronics",
      "da-DK": "Elektronik"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "18a2d3a4-424f-4aa6-ad17-61f916133edb",
    "BusinessUnits": []
  },
  {
    "Id": 11,
    "ParentId": 1,
    "SortOrder": 2,
    "CatalogueUid": "245b9772-d981-4d98-a77e-20ecf86112c2",
    "Created": "2026-04-10T18:51:56.1606267+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1606268+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Clothing",
      "da-DK": "Tøj"
    },
    "Dynamic": false,
    "QuerySetup": null,
    "WorkflowStateUid": "9ab2e067-baf8-42c9-ba60-816c5c1b4957",
    "BusinessUnits": []
  },
  {
    "Id": 12,
    "ParentId": 2,
    "SortOrder": 3,
    "CatalogueUid": "245b9772-d981-4d98-a77e-20ecf86112c2",
    "Created": "2026-04-10T18:51:56.1606272+00:00",
    "CreatedBy": "Struct",
    "LastModified": "2026-04-10T18:51:56.1606273+00:00",
    "LastModifiedBy": "Struct",
    "HasChildren": true,
    "Name": {
      "en-GB": "Wine",
      "da-DK": "Vin"
    },
    "Dynamic": true,
    "QuerySetup": {
      "ProductQuery": {
        "SubQueries": [
          {
            "Filters": [
              {
                "FieldUid": "be987a40-30ea-46a0-b3d4-c033623216cf_NA_NA",
                "QueryOperator": {},
                "FilterValue": ">-30d"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          },
          {
            "Filters": [
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "d671ca19-961e-4fa5-af6b-7ab8d1b967a7"
              },
              {
                "FieldUid": "6a61446d-bfbb-499b-80d6-70686cbaaf31_bfc13a18-d1d4-4f3e-a75f-acb702dbffc2_en-GB_NA",
                "QueryOperator": {},
                "FilterValue": "c5e97e8d-687b-4bc8-86e1-3b6c1b5d9c1a"
              }
            ],
            "BooleanOperator": {},
            "QueryModelType": "SimpleQueryModel"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "BooleanQueryModel"
      },
      "VariantGroupQuery": null
    },
    "WorkflowStateUid": "52e23e54-ed44-47bd-9d1d-636e570332c9",
    "BusinessUnits": []
  }
]

Get ids of products in a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get products for

Query parameters
includeArchivedbooleanOptional

Include archived products

Default: false
Responses
200

OK

application/json
integer · int32[]Optional
get/v1/categories/{id}/products
GET /v1/categories/{id}/products HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  3021,
  20311,
  3021,
  30331,
  34503,
  20234,
  4532,
  53225
]

Get ids of products in a categories

post
Authorizations
AuthorizationstringRequired
Body

Wrapper for product children batch query

CategoryIdsinteger · int32[] · nullableOptional

Category ids to request products for

IncludeArchivedbooleanOptional

Indicate whether archibed products shall also be included

Responses
200

OK

application/json
Other propertiesinteger · int32[]Optional
post/v1/categories/batch/products
POST /v1/categories/batch/products HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "CategoryIds": [
    1
  ],
  "IncludeArchived": true
}
200

OK

{
  "10": [
    3021,
    20311,
    3021,
    30331,
    34503,
    20234,
    4532,
    53225
  ],
  "11": [
    1000,
    1266,
    65355
  ],
  "12": [
    1566,
    6568,
    6866,
    668443,
    4852
  ]
}

Get the number of products in a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get product count for

Query parameters
includeArchivedbooleanOptional

Include archived products in count

Default: false
Responses
200

OK

application/json
integer · int32Optional
get/v1/categories/{id}/products/count
GET /v1/categories/{id}/products/count HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

233

Get the number of products in a batch of categories

post
Authorizations
AuthorizationstringRequired
Body

Wrapper for product children batch query

CategoryIdsinteger · int32[] · nullableOptional

Category ids to request products for

IncludeArchivedbooleanOptional

Indicate whether archibed products shall also be included

Responses
200

OK

application/json
Other propertiesinteger · int32Optional
post/v1/categories/batch/products/count
POST /v1/categories/batch/products/count HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "CategoryIds": [
    1
  ],
  "IncludeArchived": true
}
200

OK

{
  "10": 233,
  "11": 107,
  "12": 2036
}

Get ids of variant groups in a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get variant groups for

Query parameters
includeArchivedbooleanOptional

Include archived variant groups

Default: false
Responses
200

OK

application/json
integer · int32[]Optional
get/v1/categories/{id}/variantgroups
GET /v1/categories/{id}/variantgroups HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  3021,
  20311,
  3021,
  30331,
  34503,
  20234,
  4532,
  53225
]

Get ids of variant groups in a categories

post
Authorizations
AuthorizationstringRequired
Body

Wrapper for variant group children batch query

CategoryIdsinteger · int32[] · nullableOptional

Category ids to request variant groups for

IncludeArchivedbooleanOptional

Indicate whether archibed products shall also be included

Responses
200

OK

application/json
Other propertiesinteger · int32[]Optional
post/v1/categories/batch/variantgroups
POST /v1/categories/batch/variantgroups HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "CategoryIds": [
    1
  ],
  "IncludeArchived": true
}
200

OK

{
  "10": [
    3021,
    20311,
    3021,
    30331,
    34503,
    20234,
    4532,
    53225
  ],
  "11": [
    1000,
    1266,
    65355
  ],
  "12": [
    1566,
    6568,
    6866,
    668443,
    4852
  ]
}

Get the number of variant groups in a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get variant groups count for

Query parameters
includeArchivedbooleanOptional

Include archived variant groups in count

Default: false
Responses
200

OK

application/json
integer · int32Optional
get/v1/categories/{id}/variantgroups/count
GET /v1/categories/{id}/variantgroups/count HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

233

Get the number of variant groups in a batch of categories

post
Authorizations
AuthorizationstringRequired
Body

Wrapper for variant group children batch query

CategoryIdsinteger · int32[] · nullableOptional

Category ids to request variant groups for

IncludeArchivedbooleanOptional

Indicate whether archibed products shall also be included

Responses
200

OK

application/json
Other propertiesinteger · int32Optional
post/v1/categories/batch/variantgroups/count
POST /v1/categories/batch/variantgroups/count HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "CategoryIds": [
    1
  ],
  "IncludeArchived": true
}
200

OK

{
  "10": 233,
  "11": 107,
  "12": 2036
}

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

get

Use to get a map from an identifier to the internal id of a category in the system. Identifiers are based on attribute values that hold references to external systems. Thus, the identifier can be the id of the category in an external system. You can then use this map to know which category id to update or delete based on the id of the corresponding category in the external system

Authorizations
AuthorizationstringRequired
Path parameters
identifierAliasstringRequired

Alias of identifier type

Responses
200

OK

application/json
Other propertiesinteger · int32Optional
get/v1/categories/identifiers/{identifierAlias}
GET /v1/categories/identifiers/{identifierAlias} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "AX_Electronics": 10,
  "AX_Clothing": 11,
  "AX_Wine": 13
}

Get the internal id of a category based on its identifier

get

Use to get a map from an identifier to the internal id of a category in the system. Identifiers are based on attribute values that hold references to external systems. Thus, the identifier can be the id of the category in an external system. You can then use this map to know which category id to update or delete based on the id of the corresponding category in the external system

Authorizations
AuthorizationstringRequired
Path parameters
identifierAliasstringRequired

Alias of identifier type

identifierstringRequired

Identifier value

Responses
200

OK

application/json
integer · int32Optional
get/v1/categories/identifiers/{identifierAlias}/{identifier}
GET /v1/categories/identifiers/{identifierAlias}/{identifier} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

13

Get internal ids of multiple categories from their identifier

post

Use to get a map from an identifier to the internal id of a category in the system. Identifiers are based on attribute values that hold references to external systems. Thus, the identifier can be the id of the category in an external system. You can then use this map to know which category id to update or delete based on the id of the corresponding category in the external system

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
Other propertiesinteger · int32Optional
post/v1/categories/batch/identifiers
POST /v1/categories/batch/identifiers HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

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

OK

{
  "AX_Electronics": 10,
  "AX_Clothing": 11,
  "AX_Wine": 13,
  "AX_Food": null
}

Get attribute values for the category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

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

Category attribute values container

CategoryIdinteger · int32Optional

Id of category

get/v1/categories/{id}/attributevalues
GET /v1/categories/{id}/attributevalues HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "CategoryId": 10,
  "Values": {
    "Name": [
      {
        "CultureCode": "en-GB",
        "Data": "Electronics"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Elektronik"
      }
    ],
    "HeaderImage": "3013",
    "Description": [
      {
        "CultureCode": "en-GB",
        "Data": "See all the latest and greatest electronics"
      },
      {
        "CultureCode": "da-DK",
        "Data": "Se alt det nyeste indenfor elektronik"
      }
    ]
  }
}
patch
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

Body
Other propertiesanyOptional
Responses
200

OK

No content
patch/v1/categories/{id}/attributevalues
PATCH /v1/categories/{id}/attributevalues HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 284

{
  "Name": [
    {
      "CultureCode": "en-GB",
      "Data": "Electronics"
    },
    {
      "CultureCode": "da-DK",
      "Data": "Elektronik"
    }
  ],
  "HeaderImage": "3013",
  "Description": [
    {
      "CultureCode": "en-GB",
      "Data": "See all the latest and greatest electronics"
    },
    {
      "CultureCode": "da-DK",
      "Data": "Se alt det nyeste indenfor elektronik"
    }
  ]
}
200

OK

No content

Get attribute values for multiple categories

post

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

Authorizations
AuthorizationstringRequired
Body

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

CategoryIdsinteger · int32[] · nullableOptional

Ids of categories 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

Category attribute values container

CategoryIdinteger · int32Optional

Id of category

post/v1/categories/batch/attributevalues
POST /v1/categories/batch/attributevalues HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 260

{
  "CategoryIds": [
    1
  ],
  "IncludeValues": 1,
  "Scopes": [
    "text"
  ],
  "Aliases": [
    "text"
  ],
  "Uids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "LimitToCultureCodes": [
    "text"
  ],
  "LimitToSegments": [
    "text"
  ],
  "GlobalListValueReferencesOnly": true,
  "FromTimestamp": "2026-01-01T00:00:00.000Z"
}
[
  {
    "CategoryId": 10,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Elektronik"
        }
      ],
      "HeaderImage": "3013",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor elektronik"
        }
      ]
    }
  },
  {
    "CategoryId": 11,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Tøj"
        }
      ],
      "HeaderImage": "3014",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor tøj"
        }
      ]
    }
  },
  {
    "CategoryId": 11,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Vin"
        }
      ],
      "HeaderImage": "3015",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor vin"
        }
      ]
    }
  }
]

Update attribute values on multiple categories

patch

A maximum of 5000 categories can be updated in one request

Authorizations
AuthorizationstringRequired
Bodyobject · Struct.App.Api.Models.Catalogue.CategoryAttributeValuesModel[]

Category attribute values container

CategoryIdinteger · int32Optional

Id of category

Responses
200

OK

No content
patch/v1/categories/attributevalues
PATCH /v1/categories/attributevalues HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 891

[
  {
    "CategoryId": 10,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Elektronik"
        }
      ],
      "HeaderImage": "3013",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest electronics"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor elektronik"
        }
      ]
    }
  },
  {
    "CategoryId": 11,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Tøj"
        }
      ],
      "HeaderImage": "3014",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest clothing"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor tøj"
        }
      ]
    }
  },
  {
    "CategoryId": 12,
    "Values": {
      "Name": [
        {
          "CultureCode": "en-GB",
          "Data": "Wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Vin"
        }
      ],
      "HeaderImage": "3015",
      "Description": [
        {
          "CultureCode": "en-GB",
          "Data": "See all the latest and greatest wine"
        },
        {
          "CultureCode": "da-DK",
          "Data": "Se alt det nyeste indenfor vin"
        }
      ]
    }
  }
]
200

OK

No content

Get rendered attribute values for a category

get
Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

Query parameters
renderCultureCodestringOptional

Culture code to use for rendering localized attribute values. If not provided, invariant culture will be used

Responses
200

OK

application/json

Wraps rendered attribute values for a category

CategoryIdinteger · int32Optional

Id of the category for which the attribute values are rendered

get/v1/categories/{id}/attributevalues/rendered
GET /v1/categories/{id}/attributevalues/rendered HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "CategoryId": 2011,
  "RenderedValues": [
    {
      "AttributeAlias": "Name",
      "DisplayName": {
        "en-GB": "Name",
        "da-DK": "Navn"
      },
      "RenderedValues": [
        {
          "CultureCode": null,
          "Segment": null,
          "Dimension": null,
          "Value": "Laptops",
          "Unit": null
        }
      ]
    },
    {
      "AttributeAlias": "Description",
      "DisplayName": {
        "en-GB": "Description",
        "da-DK": "Beskrivelse"
      },
      "RenderedValues": [
        {
          "CultureCode": "en-GB",
          "Segment": null,
          "Dimension": null,
          "Value": "The laptops you need",
          "Unit": null
        },
        {
          "CultureCode": "da-DK",
          "Segment": null,
          "Dimension": null,
          "Value": "De bærbare to har brug for",
          "Unit": null
        }
      ]
    },
    {
      "AttributeAlias": "ShortDescription",
      "DisplayName": {
        "en-GB": "Short Description",
        "da-DK": "Kort beskrivelse"
      },
      "RenderedValues": [
        {
          "CultureCode": "en-GB",
          "Segment": "EMEA",
          "Dimension": "Market",
          "Value": "All laptops",
          "Unit": null
        },
        {
          "CultureCode": "en-GB",
          "Segment": "ASIA",
          "Dimension": "Market",
          "Value": "All our laptops",
          "Unit": null
        },
        {
          "CultureCode": "da-DK",
          "Segment": "EMEA",
          "Dimension": "Market",
          "Value": "Alle laptops",
          "Unit": null
        },
        {
          "CultureCode": "da-DK",
          "Segment": "ASIA",
          "Dimension": "Market",
          "Value": "Alle vores laptops",
          "Unit": null
        }
      ]
    },
    {
      "AttributeAlias": "PrimaryImage",
      "DisplayName": {
        "en-GB": "Primary image",
        "da-DK": "primært billede"
      },
      "RenderedValues": [
        {
          "CultureCode": null,
          "Segment": null,
          "Dimension": null,
          "Value": "20111",
          "Unit": null
        }
      ]
    }
  ]
}

Get rendered attribute values for multiple categories

post

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

Authorizations
AuthorizationstringRequired
Body

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

CategoryIdsinteger · int32[] · nullableOptional

Ids of variants 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

RenderCultureCodestring · nullableOptional

Culture code to use for rendering values (eg. to control decimal separator, datetime rendering etc.). If not provided, Invariant culture will be used

Responses
200

OK

application/json

Wraps rendered attribute values for a category

CategoryIdinteger · int32Optional

Id of the category for which the attribute values are rendered

post/v1/categories/batch/attributevalues/rendered
POST /v1/categories/batch/attributevalues/rendered HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 207

{
  "CategoryIds": [
    1
  ],
  "IncludeValues": 1,
  "Scopes": [
    "text"
  ],
  "Aliases": [
    "text"
  ],
  "Uids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "LimitToCultureCodes": [
    "text"
  ],
  "LimitToSegments": [
    "text"
  ],
  "RenderCultureCode": "text"
}
200

OK

[
  {
    "CategoryId": 2011,
    "RenderedValues": [
      {
        "AttributeAlias": "Name",
        "DisplayName": {
          "en-GB": "Name",
          "da-DK": "Navn"
        },
        "RenderedValues": [
          {
            "CultureCode": null,
            "Segment": null,
            "Dimension": null,
            "Value": "Laptops",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "Description",
        "DisplayName": {
          "en-GB": "Description",
          "da-DK": "Beskrivelse"
        },
        "RenderedValues": [
          {
            "CultureCode": "en-GB",
            "Segment": null,
            "Dimension": null,
            "Value": "The laptops you need",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": null,
            "Dimension": null,
            "Value": "De bærbare to har brug for",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "ShortDescription",
        "DisplayName": {
          "en-GB": "Short Description",
          "da-DK": "Kort beskrivelse"
        },
        "RenderedValues": [
          {
            "CultureCode": "en-GB",
            "Segment": "EMEA",
            "Dimension": "Market",
            "Value": "All laptops",
            "Unit": null
          },
          {
            "CultureCode": "en-GB",
            "Segment": "ASIA",
            "Dimension": "Market",
            "Value": "All our laptops",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": "EMEA",
            "Dimension": "Market",
            "Value": "Alle laptops",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": "ASIA",
            "Dimension": "Market",
            "Value": "Alle vores laptops",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "PrimaryImage",
        "DisplayName": {
          "en-GB": "Primary image",
          "da-DK": "primært billede"
        },
        "RenderedValues": [
          {
            "CultureCode": null,
            "Segment": null,
            "Dimension": null,
            "Value": "20111",
            "Unit": null
          }
        ]
      }
    ]
  },
  {
    "CategoryId": 2011,
    "RenderedValues": [
      {
        "AttributeAlias": "Name",
        "DisplayName": {
          "en-GB": "Name",
          "da-DK": "Navn"
        },
        "RenderedValues": [
          {
            "CultureCode": null,
            "Segment": null,
            "Dimension": null,
            "Value": "T-shirts",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "Description",
        "DisplayName": {
          "en-GB": "Description",
          "da-DK": "Beskrivelse"
        },
        "RenderedValues": [
          {
            "CultureCode": "en-GB",
            "Segment": null,
            "Dimension": null,
            "Value": "The t-shirts you need",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": null,
            "Dimension": null,
            "Value": "De t-shirts har brug for",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "ShortDescription",
        "DisplayName": {
          "en-GB": "Short Description",
          "da-DK": "Kort beskrivelse"
        },
        "RenderedValues": [
          {
            "CultureCode": "en-GB",
            "Segment": "EMEA",
            "Dimension": "Market",
            "Value": "All T-shirts",
            "Unit": null
          },
          {
            "CultureCode": "en-GB",
            "Segment": "ASIA",
            "Dimension": "Market",
            "Value": "All our T-shirts",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": "EMEA",
            "Dimension": "Market",
            "Value": "Alle T-shirts",
            "Unit": null
          },
          {
            "CultureCode": "da-DK",
            "Segment": "ASIA",
            "Dimension": "Market",
            "Value": "Alle vores T-shirts",
            "Unit": null
          }
        ]
      },
      {
        "AttributeAlias": "PrimaryImage",
        "DisplayName": {
          "en-GB": "Primary image",
          "da-DK": "primært billede"
        },
        "RenderedValues": [
          {
            "CultureCode": null,
            "Segment": null,
            "Dimension": null,
            "Value": "20112",
            "Unit": null
          }
        ]
      }
    ]
  }
]

Get product attributes on category

get
Authorizations
AuthorizationstringRequired
Query parameters
categoryIdinteger · int32Optional

Id of category to get attached attributes from

Responses
200

OK

application/json

Represents an attribute connection to a category in the master catalogue

AttributeUidstring · uuidOptional

Uid of attribute

CategoryIdinteger · int32Optional

Id of category to which the attribute is connected

Ownerinteger · int32Optional

Id of the category at which this connection originates (will be different from category id if this attachment is inherited from a higher level category)

EditableOnEntitiesinteger · enumOptional

Represents where attributes added to categories are editable on entities placed in that category

  • 0 = ProductAndVariant: Attributes are editable on both products and variants
  • 1 = Product: Attributes are editable on products only
  • 2 = Variant: Attributes are editable on variants only
  • 3 = None: Attributes are not editable on any entity
Possible values:
SortOrderinteger · int32 · nullableOptional

Sort order of the attribute

get/v1/categories/productattributes
GET /v1/categories/productattributes HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "AttributeUid": "c79cf9bd-2262-48a9-abdc-b4dcdf2c2d9c",
    "CategoryId": 10,
    "Owner": 10,
    "EditableOnEntities": {},
    "SortOrder": null
  },
  {
    "AttributeUid": "375e30bc-9dcf-4c17-86a7-4187ae353956",
    "CategoryId": 10,
    "Owner": 10,
    "EditableOnEntities": {},
    "SortOrder": null
  },
  {
    "AttributeUid": "8646d460-02be-4dd6-9c1f-86156277eac4",
    "CategoryId": 10,
    "Owner": 10,
    "EditableOnEntities": {},
    "SortOrder": null
  }
]

Attach attribute to a category, which is to be visible to products in that category

post
Authorizations
AuthorizationstringRequired
Query parameters
categoryIdinteger · int32Optional

Id of category to attach attribute to

attributeUidstring · uuidOptional

Uid of attribute to attach

editableOnEntitiesinteger · enumOptional

Represents where attributes added to categories are editable on entities placed in that category

  • 0 = ProductAndVariant: Attributes are editable on both products and variants
  • 1 = Product: Attributes are editable on products only
  • 2 = Variant: Attributes are editable on variants only
  • 3 = None: Attributes are not editable on any entity
Possible values:
sortOrderinteger · int32Optional

Sort order of attribute on category

Responses
200

OK

No content
post/v1/categories/productattributes
POST /v1/categories/productattributes HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content

Remove a product attribute from a category

delete
Authorizations
AuthorizationstringRequired
Query parameters
categoryIdinteger · int32Optional

Id of category the attribute is attached to

attributeUidstring · uuidOptional

Uid of attached attribute

Responses
200

OK

No content
delete/v1/categories/productattributes
DELETE /v1/categories/productattributes HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

Update attribute on a category

patch
Authorizations
AuthorizationstringRequired
Query parameters
categoryIdinteger · int32Optional

Id of category the attribute is attached to

attributeUidstring · uuidOptional

Uid of attached attribute

editableOnEntitiesinteger · enumOptional

Represents where attributes added to categories are editable on entities placed in that category

  • 0 = ProductAndVariant: Attributes are editable on both products and variants
  • 1 = Product: Attributes are editable on products only
  • 2 = Variant: Attributes are editable on variants only
  • 3 = None: Attributes are not editable on any entity
Possible values:
sortOrderinteger · int32Optional

Sort order of attribute on category

Responses
200

OK

No content
patch/v1/categories/productattributes
PATCH /v1/categories/productattributes HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

Get references to a category

get

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

Responses
200

OK

application/json

Model holding references from other entities to a category

CategoryIdinteger · int32Optional

Id of the referenced category

ReferencingGlobalListValuesstring · uuid[] · nullableOptional

List of global list values referencing this category

get/v1/categories/{id}/references
GET /v1/categories/{id}/references HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "CategoryId": 12,
  "ReferencingCategories": [
    {
      "EntityId": 100,
      "AttributeUid": "578642e8-17bb-4a94-8975-cd494db6b1c0"
    },
    {
      "EntityId": 101,
      "AttributeUid": "578642e8-17bb-4a94-8975-cd494db6b1c0"
    }
  ],
  "ReferencingProducts": [
    {
      "EntityId": 100010,
      "AttributeUid": "cc025505-0257-4896-b75b-829aa1fbf9c1"
    },
    {
      "EntityId": 100011,
      "AttributeUid": "cc025505-0257-4896-b75b-829aa1fbf9c1"
    },
    {
      "EntityId": 102354,
      "AttributeUid": "16df80d0-f6b5-41ff-a847-b85a734593bb"
    }
  ],
  "ReferencingVariantGroups": [],
  "ReferencingVariants": [
    {
      "EntityId": 100,
      "AttributeUid": "cc025505-0257-4896-b75b-829aa1fbf9c1"
    }
  ],
  "ReferencingAssets": [],
  "ReferencingGlobalListValues": [
    "79f7df35-2866-4357-bda3-ac2b18b3a7df",
    "794c46c0-0285-440a-94c3-709a18609ff4"
  ]
}

Get references to a batch of categories

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

Model holding references from other entities to a category

CategoryIdinteger · int32Optional

Id of the referenced category

ReferencingGlobalListValuesstring · uuid[] · nullableOptional

List of global list values referencing this category

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

[
  1
]
200

OK

[
  {
    "CategoryId": 12,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "5b762134-e32e-459c-97b1-e73962f8d716"
      },
      {
        "EntityId": 101,
        "AttributeUid": "5b762134-e32e-459c-97b1-e73962f8d716"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 100010,
        "AttributeUid": "c0e4636d-5ef1-427c-8dc0-ef164e698f67"
      },
      {
        "EntityId": 100011,
        "AttributeUid": "c0e4636d-5ef1-427c-8dc0-ef164e698f67"
      },
      {
        "EntityId": 102354,
        "AttributeUid": "e033c0ab-fd87-4ec1-b601-68a95c2c5b66"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 100,
        "AttributeUid": "c0e4636d-5ef1-427c-8dc0-ef164e698f67"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "90b2ff4f-032d-421c-807d-b988daeeb02a",
      "ca892f7b-aa54-48de-9784-e9fd39725eb1"
    ]
  },
  {
    "CategoryId": 20,
    "ReferencingCategories": [
      {
        "EntityId": 100,
        "AttributeUid": "5b762134-e32e-459c-97b1-e73962f8d716"
      }
    ],
    "ReferencingProducts": [
      {
        "EntityId": 23553,
        "AttributeUid": "c0e4636d-5ef1-427c-8dc0-ef164e698f67"
      },
      {
        "EntityId": 5656,
        "AttributeUid": "c0e4636d-5ef1-427c-8dc0-ef164e698f67"
      }
    ],
    "ReferencingVariantGroups": [],
    "ReferencingVariants": [
      {
        "EntityId": 568323,
        "AttributeUid": "e033c0ab-fd87-4ec1-b601-68a95c2c5b66"
      }
    ],
    "ReferencingAssets": [],
    "ReferencingGlobalListValues": [
      "883d2591-8484-432b-8487-523a40ee3c0e",
      "6017b132-3dc4-488a-a6f7-4fbf96398839"
    ]
  }
]

Get Enrichment Insights for a category

get

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category to get insights for

Responses
200

OK

application/json

Model representing an entity's enrichment insight

EnrichmentInsightSetupUidstring · uuidOptional

Uid of enrichment insight

EntityIdinteger · int32Optional

Id of entity

Completenessinteger · int32 · nullableOptional

Completeness in percentage (0 - 100). Is null, if ignored is true

IgnoredbooleanOptional

Indicates whether the completeness is ignored for this entity and this enrichment insight

get/v1/categories/{id}/enrichmentinsights
GET /v1/categories/{id}/enrichmentinsights HTTP/1.1
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 categories

post

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

application/json

Model representing an entity's enrichment insight

EnrichmentInsightSetupUidstring · uuidOptional

Uid of enrichment insight

EntityIdinteger · int32Optional

Id of entity

Completenessinteger · int32 · nullableOptional

Completeness in percentage (0 - 100). Is null, if ignored is true

IgnoredbooleanOptional

Indicates whether the completeness is ignored for this entity and this enrichment insight

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

[
  1
]
200

OK

[
  {
    "EnrichmentInsightSetupUid": "311d37fa-d5fb-426b-91ea-e4eae7ab2ed3",
    "EntityId": 1974035,
    "Completeness": 50,
    "MissingData": [
      {
        "Type": "AttributeInsightsDataReference",
        "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
      }
    ],
    "Ignored": false
  },
  {
    "EnrichmentInsightSetupUid": "311d37fa-d5fb-426b-91ea-e4eae7ab2ed3",
    "EntityId": 1974043,
    "Completeness": 100,
    "MissingData": [],
    "Ignored": false
  }
]

Get insights for a batch of categories 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 categories

Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

application/json

Model representing an entity's enrichment insight

EnrichmentInsightSetupUidstring · uuidOptional

Uid of enrichment insight

EntityIdinteger · int32Optional

Id of entity

Completenessinteger · int32 · nullableOptional

Completeness in percentage (0 - 100). Is null, if ignored is true

IgnoredbooleanOptional

Indicates whether the completeness is ignored for this entity and this enrichment insight

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

[
  1
]
200

OK

[
  {
    "EnrichmentInsightSetupUid": "38c18cff-aa08-404e-ab56-62fca692e1a1",
    "EntityId": 1974035,
    "Completeness": 50,
    "MissingData": [
      {
        "Type": "AttributeInsightsDataReference",
        "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
      }
    ],
    "Ignored": false
  },
  {
    "EnrichmentInsightSetupUid": "38c18cff-aa08-404e-ab56-62fca692e1a1",
    "EntityId": 1974043,
    "Completeness": 100,
    "MissingData": [],
    "Ignored": false
  }
]

Enable or disable an enrichment insight for a category

patch

#Available from v.3.5.0

Authorizations
AuthorizationstringRequired
Path parameters
idinteger · int32Required

Id of category

enrichmentInsightSetupUidstring · uuidRequired

Uid of enrichment insight to toggle ignore for

ignorebooleanRequired

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

Responses
200

OK

No content
patch/v1/categories/{id}/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore}
PATCH /v1/categories/{id}/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

Enable or disable an enrichment insight for a batch of categories

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 categories

Bodyinteger · int32[]
integer · int32[]Optional
Responses
200

OK

No content
patch/v1/categories/batch/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore}
PATCH /v1/categories/batch/enrichmentinsights/{enrichmentInsightSetupUid}/{ignore} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 3

[
  1
]
200

OK

No content

Get ids of categories 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
integer · int32[]Optional
post/v1/categories/search
POST /v1/categories/search HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 552

{
  "IncludeArchived": false,
  "QueryModel": {
    "SubQueries": [
      {
        "Filters": [
          {
            "FieldUid": "6a5d7f84-1d34-4f96-b5c3-7a6e1d2b4c90_NA_NA",
            "QueryOperator": {},
            "FilterValue": "DK"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      },
      {
        "Filters": [
          {
            "FieldUid": "89b4cda9-d803-4812-9862-51167c809f2c_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "red"
          },
          {
            "FieldUid": "89b4cda9-d803-4812-9862-51167c809f2c_en-GB_NA",
            "QueryOperator": {},
            "FilterValue": "blue"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      }
    ],
    "BooleanOperator": {},
    "QueryModelType": "BooleanQueryModel"
  }
}
200

OK

[
  10021,
  20311,
  234032,
  23134,
  53451,
  32433,
  23481
]

Get paged result of categories 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
TotalHitsinteger · int32Optional
Pageinteger · int32Optional
PageSizeinteger · int32Optional
TotalPagesinteger · int32Optional
post/v1/categories/search/paged
POST /v1/categories/search/paged HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 379

{
  "Page": 1,
  "PageSize": 10,
  "FieldUids": [
    "Id",
    "PIM_Name_1"
  ],
  "SortByFieldUid": "Id",
  "SortDescending": true,
  "IncludeArchived": false,
  "QueryModel": {
    "SubQueries": [
      {
        "Filters": [
          {
            "FieldUid": "6a5d7f84-1d34-4f96-b5c3-7a6e1d2b4c90_NA_NA",
            "QueryOperator": {},
            "FilterValue": "DK"
          }
        ],
        "BooleanOperator": {},
        "QueryModelType": "SimpleQueryModel"
      }
    ],
    "BooleanOperator": {},
    "QueryModelType": "BooleanQueryModel"
  }
}
200

OK

{
  "TotalHits": 55,
  "Page": 1,
  "PageSize": 3,
  "TotalPages": 19,
  "ItemListHeaders": [
    {
      "FieldUid": "Id",
      "FieldName": "Internal Id",
      "FieldType": "string",
      "SupportsSearching": true,
      "SupportsSorting": true
    },
    {
      "FieldUid": "PIM_Name_1",
      "FieldName": "Internal Name (en-GB)",
      "FieldType": "string",
      "SupportsSearching": true,
      "SupportsSorting": true
    }
  ],
  "ListItems": [
    {
      "Id": 10,
      "ShownValues": [
        "10",
        "Electronics"
      ]
    },
    {
      "Id": 11,
      "ShownValues": [
        "11",
        "Clothing"
      ]
    },
    {
      "Id": 12,
      "ShownValues": [
        "12",
        "Wine"
      ]
    }
  ]
}

Get all available query fields in the PIM installation

get
Authorizations
AuthorizationstringRequired
Responses
200

OK

application/json

Representation of a queryable field in PIM

Uidstring · nullableOptional

Unique id of field in PIM

Namestring · nullableOptional

The display name of the field

SupportsSortingbooleanOptional

If true field can be used for sorting

get/v1/categories/queryablefields
GET /v1/categories/queryablefields HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "Uid": "PIM_CategoryIds",
    "Name": "CategoryIds",
    "SupportsSorting": false
  },
  {
    "Uid": "PIM_Name_1",
    "Name": "Internal Name (en-GB)",
    "SupportsSorting": false
  },
  {
    "Uid": "PIM_Name_3",
    "Name": "Internal Name (da-DK)",
    "SupportsSorting": false
  },
  {
    "Uid": "89b4cda9-d803-4812-9862-51167c809f2c_en-GB_NA",
    "Name": "Name (en-GB)",
    "SupportsSorting": false
  },
  {
    "Uid": "89b4cda9-d803-4812-9862-51167c809f2c_da-DK_NA",
    "Name": "Name (da-DK)",
    "SupportsSorting": false
  },
  {
    "Uid": "7f2c7c6e-6d7f-4be0-b239-8db011f4c7a1_en-GB_NA",
    "Name": "Description (en-GB)",
    "SupportsSorting": false
  },
  {
    "Uid": "7f2c7c6e-6d7f-4be0-b239-8db011f4c7a1_da-DK_NA",
    "Name": "Description (da-DK)",
    "SupportsSorting": false
  }
]
PreviousCatalogues
NextDimensions

Last updated