List Categories
Retrieves a paginated list of categories for an app with optional search, sorting, and filtering capabilities
GET
/api/v1/{team_slug}/{app_slug}/categoriesAuthorization
AuthorizationBearer token · headerrequiredManagement API token, sent as Authorization: Bearer <token>.
Path parameters
app_slugstringrequiredApp slug
team_slugstringrequiredTeam slug
Query parameters
searchstringSearch on category name
pageintegerPage number (default is 1)
per-pageintegerAmount of products per page. Minimum 0 and max 100 (default is 20)
sort-orderstringSort order. Should be one of ASC or DESC. Default DESC
sort-keystringThe key to sort on. Can be one of name, sort_order, created-at, updated-at (Default is created-at)
idstring[]Filter by category IDs (can be repeated)
attribute-idstring[]Filter by attribute IDs
Responses
200
Categories list
datagithub_com_enadhq_nabbit_internal_pkg_webserver_models.Category[]requiredShow propertiesHide properties
Array of
github_com_enadhq_nabbit_internal_pkg_webserver_models.Categoryattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullShow propertiesHide properties
Array of
github_com_enadhq_nabbit_internal_pkg_webserver_models.Attributecreated_atstringdescriptionstring | nullfilterableboolean | nullidstringkeystringnamestring | nulltemplate_keystringtemplate_namestringtranslatableboolean | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.AttributeTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]updated_atstring | nullvaluesobject | nullchildrengithub_com_enadhq_nabbit_internal_pkg_webserver_models.Category[]Show propertiesHide properties
Array of
github_com_enadhq_nabbit_internal_pkg_webserver_models.CategoryCircular reference to
github_com_enadhq_nabbit_internal_pkg_webserver_models.Category.cover_urlstringcreated_atstringdescriptionstringgoogle_product_category_idstring | nullidstringnamestringparent_idstringredirectsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Redirects[] | nullShow propertiesHide properties
Array of
github_com_enadhq_nabbit_internal_pkg_webserver_models.Redirectsidstringitem_idstring | nulllocalestringnew_slugstringold_slugstringtypegithub_com_enadhq_nabbit_internal_pkg_webserver_models.RedirectTypeAllowed:
productpagecollectioncategoryproduct_bundleseogithub_com_enadhq_nabbit_internal_pkg_webserver_models.CategorySEO | nullShow propertiesHide properties
Any of:
github_com_enadhq_nabbit_internal_pkg_webserver_models.CategorySEO
meta_descriptionstringmeta_titlestringnull
nullslugstringsort_orderintegerstatusstringtranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.CategoryTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]Show propertiesHide properties
Array of
github_com_enadhq_nabbit_internal_pkg_webserver_models.Translationidstringlocalestringvaluestringmeta_descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]meta_titlegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullsluggithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullupdated_atstring | nulluristring | nullsuccessbooleantotalintegertotal_pagesinteger400
Invalid request (e.g. bad UUID, validation error)
detailsstring[]messagestringsuccessbooleanrequired401
Unauthorized access
detailsstring[]messagestringsuccessbooleanrequired500
Internal server error
detailsstring[]messagestringsuccessbooleanrequired