List Categories

GET {{baseUrl}}/categories?page=<integer>&keyword=<string>&status=<string>

This endpoint allows you to list all categories related to your store directly from this endpoint. Also, it allows you to filter them using a keyword, the endpoint would return any category which name matches this keyword.

categories.read- Categories Read Only

Request Params

KeyDatatypeRequiredDescription
pagestringThe Pagination page number
keywordstringA keyword to filter categories by a specific name.
statusstringThe status of the category, whether or not it is active or hidden

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;status&quot;:&quot;\u003cnumber\u003e&quot;,&quot;success&quot;:&quot;\u003cboolean\u003e&quot;,&quot;data&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;},{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;active&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;},{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;hidden&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;}],&quot;pagination&quot;:{&quot;count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;total&quot;:&quot;\u003cnumber\u003e&quot;,&quot;perPage&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currentPage&quot;:&quot;\u003cnumber\u003e&quot;,&quot;totalPages&quot;:&quot;\u003cnumber\u003e&quot;,&quot;links&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}}