Get Categories Manajemnt
Prod Env
https://v1.dev.bukalombok.com
Prod Env
https://v1.dev.bukalombok.com
GET
/v1/superadmin/management/categories
API Documentation: Get Categories
Endpoint
GET v1/superadmin/managment/catagorys?sortBy=createdAt&sortOrder=ascAuthorization
| Type | Required | Description |
|---|---|---|
| Bearer Token | ✅ | Hanya SUPER_ADMIN menampilkan seluruh katagori dengan status |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
parentId | string | No | Jika diisi, API akan mengembalikan children dari kategori ini saja. |
search | string | No | Jika diisi, API akan mengembalikan tree kategori yang mengandung keyword ini (termasuk parent chain). |
Catatan: Jika tidak ada query parameter, API akan mengembalikan root categories saja. Jika parentIddiisi, querysearchdiabaikan.
Response Format
1. Root Categories Only (Default)
GET /v1/categories{
"meta": {
"success": true,
"status": 200,
"message": "Request successful"
},
"data": [
{
"id": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"slug": "elektronik",
"name": "Elektronik",
"description": "Perangkat dan gadget elektronik",
"image": "elektronik.jpg",
"parentId": null,
"createdAt": "2025-09-08T05:24:36.934Z",
"updatedAt": "2025-09-08T05:24:36.934Z"
},
{
"id": "d82ad992-e418-40d5-bddb-60310ba8cbe2",
"slug": "fashion",
"name": "Fashion",
"description": "Pakaian dan aksesoris",
"image": "fashion.jpg",
"parentId": null,
"createdAt": "2025-09-08T05:24:36.937Z",
"updatedAt": "2025-09-08T05:24:36.937Z"
}
]
}2. Children By Parent ID
GET /v1/categories?parentId=bc67a3a3-c46f-4b24-9fbf-e85b43088a83{
"meta": {
"success": true,
"status": 200,
"message": "Request successful"
},
"data": [
{
"id": "3a6f51ec-58ed-43e7-a7f5-363ff39d493e",
"slug": "laptop",
"name": "Laptop",
"description": "Berbagai jenis laptop",
"image": "laptop.jpg",
"parentId": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"createdAt": "2025-09-08T05:24:36.942Z",
"updatedAt": "2025-09-08T05:24:36.942Z"
},
{
"id": "da4a8713-f6f5-4d00-bb20-4c09b821c9a2",
"slug": "smartphone",
"name": "Smartphone",
"description": "Berbagai jenis smartphone",
"image": "smartphone.jpg",
"parentId": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"createdAt": "2025-09-08T05:24:36.939Z",
"updatedAt": "2025-09-08T05:24:36.939Z"
}
]
}3. Search Tree Mode
GET /v1/categories?search=laptop{
"meta": {
"success": true,
"status": 200,
"message": "Request successful"
},
"data": [
{
"id": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"slug": "elektronik",
"name": "Elektronik",
"description": "Perangkat dan gadget elektronik",
"image": "elektronik.jpg",
"parentId": null,
"createdAt": "2025-09-08T05:24:36.934Z",
"updatedAt": "2025-09-08T05:24:36.934Z",
"children": [
{
"id": "3a6f51ec-58ed-43e7-a7f5-363ff39d493e",
"slug": "laptop",
"name": "Laptop",
"description": "Berbagai jenis laptop",
"image": "laptop.jpg",
"parentId": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"createdAt": "2025-09-08T05:24:36.942Z",
"updatedAt": "2025-09-08T05:24:36.942Z",
"children": [
{
"id": "73151aeb-2a4f-43ac-8a70-d054e6fd11c1",
"slug": "ultrabook",
"name": "Ultrabook",
"description": "Laptop tipis dan ringan",
"image": "https://image/ultrabook.jpg",
"parentId": "3a6f51ec-58ed-43e7-a7f5-363ff39d493e",
"createdAt": "2025-09-08T05:24:36.950Z",
"updatedAt": "2025-09-08T05:24:36.950Z",
"children": []
}
]
}
]
}
]
}Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v1.dev.bukalombok.com/v1/superadmin/management/categories' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success - Success
{
"meta": {
"success": true,
"status": 200,
"message": "Request successful"
},
"data": [
{
"id": "bc67a3a3-c46f-4b24-9fbf-e85b43088a83",
"slug": "elektronik",
"name": "Elektronik",
"description": "Perangkat dan gadget elektronik",
"image": "elektronik.jpg",
"parentId": null,
"createdAt": "2025-09-08T05:24:36.934Z",
"updatedAt": "2025-09-08T05:24:36.934Z"
},
{
"id": "d82ad992-e418-40d5-bddb-60310ba8cbe2",
"slug": "fashion",
"name": "Fashion",
"description": "Pakaian dan aksesoris",
"image": "fashion.jpg",
"parentId": null,
"createdAt": "2025-09-08T05:24:36.937Z",
"updatedAt": "2025-09-08T05:24:36.937Z"
}
]
}Modified at 2025-10-12 17:53:47