List catalogs
Was this helpful?
Was this helpful?
Retrieve lists of catalogs
Get the filtered list of catalogs for the specified tenant. Also, sorting and paging options are available. If none are given, default values will be used.
Your Emporix tenant's name. Note: The tenant should always be written in lowercase.
saasdev2
Search by the name of the catalog.
If you want to search for the name in a specific locale, you can just append the .<locale>
, for example use name.de
.
name
Search by description of the catalog.
If you want to search for the name in a specific locale, you can just append the .<locale>
, for example use description.de
.
description
Search by a site name. The equal
operator is used here, therefore the site name must match.
Search by start date of the visibility of the catalog. It must follow the pattern yyyy-MM-dd.
2022-01-28
Search by end date of the visibility of the catalog. It must follow the pattern yyyy-MM-dd.
2022-01-28
Search by last update date of the catalog. It must follow the pattern yyyy-MM-dd.
2022-01-28
Page number to be retrieved. The number of the first page is 1.
Note: If the pageNumber
parameter is passed, size of the pages must be specified in the pageSize
parameter.
1
Number of catalogs to be retrieved per page.
60
Fields to sort the response data by following order of the parameters from left to right.
Can contain multiple fields in format: field name
:sort direction
separated by a comma.
The colon with sort direction
parameter is redundant and descending order is taken only
if it is equal to desc
or DESC
.
Ascending order is considered in any other case.
Sorting by name
parameter works properly only if the Accept-Language
header is set to
a specific language or is empty with default language specified in the configuration service.
name,description:asc
This flag specifies if the API client should receive a X-Total-Count header with the total number of elements that match the search filter.
false
List of properties used to sort the results, separated by commas. Possible values:
*
- each internationalized field is returned as a map containing all available translationsen
, en,de
- each internationalized field is returned as a map containing translation specified by a header value. If translation is not supported by tenant configuration then exception is thrown. First language is the one with highest priority.fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5
- each internationalized field is returned as a map containing translation specified by a header value. If translation is not available exception is thrown. This list must contains any possible extension for internationalized fields included in sort param.*
Example: *, 'en', 'en,de,fr', 'en-EN', 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5'
GET /catalog/{tenant}/catalogs HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"id": "3456454",
"name": {
"en": "This is a catalog"
},
"description": {
"en": "This catalog is used as an example"
},
"status": "VISIBLE",
"visibility": {
"visible": true,
"from": "2022-02-24T20:44:43.169Z",
"to": "2023-07-24T20:44:43.169Z"
},
"publishedSites": [
"Main"
],
"categoryIds": [
"3249485"
],
"metadata": {
"version": 1,
"updatedAt": "2022-02-24T20:44:43.169Z",
"createdAt": "2022-02-24T20:44:43.169Z"
}
}
]
Get all catalogs with the specified category that belong to the tenant.
Your Emporix tenant's name. Note: The tenant should always be written in lowercase.
saasdev2
The unique id of the category, that will be matched with the category identifiers stored on catalogs.
787323
Page number to be retrieved. The number of the first page is 1.
Note: If the pageNumber
parameter is passed, size of the pages must be specified in the pageSize
parameter.
1
Number of catalogs to be retrieved per page.
60
Fields to sort the response data by following order of the parameters from left to right.
Can contain multiple fields in format: field name
:sort direction
separated by a comma.
The colon with sort direction
parameter is redundant and descending order is taken only
if it is equal to desc
or DESC
.
Ascending order is considered in any other case.
Sorting by name
parameter works properly only if the Accept-Language
header is set to
a specific language or is empty with default language specified in the configuration service.
name,description:asc
This flag specifies if the API client should receive a X-Total-Count header with the total number of elements that match the search filter.
false
List of properties used to sort the results, separated by commas. Possible values:
*
- each internationalized field is returned as a map containing all available translationsen
, en,de
- each internationalized field is returned as a map containing translation specified by a header value. If translation is not supported by tenant configuration then exception is thrown. First language is the one with highest priority.fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5
- each internationalized field is returned as a map containing translation specified by a header value. If translation is not available exception is thrown. This list must contains any possible extension for internationalized fields included in sort param.*
Example: *, 'en', 'en,de,fr', 'en-EN', 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5'
GET /catalog/{tenant}/catalogs/categories/{categoryId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"id": "text",
"name": {
"0": "t",
"1": "e",
"2": "x",
"3": "t"
},
"description": {
"0": "t",
"1": "e",
"2": "x",
"3": "t"
},
"status": null,
"visibility": {
"visible": false,
"from": "text",
"to": "text"
},
"publishedSites": [
"text"
],
"metadata": {
"version": 1,
"updatedAt": "2025-06-21T11:36:28.023Z",
"createdAt": "2025-06-21T11:36:28.023Z"
},
"categoryIds": [
"text"
]
}
]
Get the catalog with the specified unique id that belongs to the tenant.
Your Emporix tenant's name. Note: The tenant should always be written in lowercase.
saasdev2
The unique id of the catalog.
787323
GET /catalog/{tenant}/catalogs/{catalogId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"id": "text",
"name": {
"0": "t",
"1": "e",
"2": "x",
"3": "t"
},
"description": {
"0": "t",
"1": "e",
"2": "x",
"3": "t"
},
"status": null,
"visibility": {
"visible": false,
"from": "text",
"to": "text"
},
"publishedSites": [
"text"
],
"metadata": {
"version": 1,
"updatedAt": "2025-06-21T11:36:28.023Z",
"createdAt": "2025-06-21T11:36:28.023Z"
},
"categoryIds": [
"text"
]
}