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": "Berhasil mengambil kategori"
},
"data": [
{
"id": "KNX3d_Q-sLZLQBv",
"slug": "test-parent",
"name": "Test Parent",
"description": "Ini adalah test parent deskripsi",
"status": "PUBLISHED",
"image": "public/category/test-parent-1767076237454-32511e.jpeg",
"parentId": null,
"createdAt": "2025-12-30T06:30:38.044Z",
"updatedAt": "2025-12-30T06:32:59.206Z"
},
{
"id": "bYvHAB3QWG6MFsv",
"slug": "category-parent",
"name": "Category Parent",
"description": "Nikamti belaja Elkronik lokal terbak",
"status": "PUBLISHED",
"image": "public/category/category-parent-1767066157285-bf5b59.jpg",
"parentId": null,
"createdAt": "2025-12-30T03:42:37.911Z",
"updatedAt": "2025-12-30T03:42:37.911Z"
},
{
"id": "1469af6e-ccc4-48b3-bb7b-dd655ca372e9",
"slug": "merchandise-branded",
"name": "Merchandise & Branded",
"description": "Merchandise resmi dan produk branded",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=117",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.338Z",
"updatedAt": "2025-12-26T08:01:37.338Z"
},
{
"id": "ba0fa1b0-1dc2-402e-aa46-6255e7c87003",
"slug": "oleh-oleh-cenderamata",
"name": "Oleh-Oleh & Cenderamata",
"description": "Oleh-oleh khas daerah dan cenderamata",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=116",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.335Z",
"updatedAt": "2025-12-26T08:01:37.335Z"
},
{
"id": "ee75abe1-a2d4-4e29-9593-522774238cad",
"slug": "bayi-anak",
"name": "Bayi & Anak-anak",
"description": "Kebutuhan bayi dan anak-anak",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=10",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.332Z",
"updatedAt": "2025-12-26T08:01:37.332Z"
},
{
"id": "b0b19f23-11d4-48d8-92eb-70defdc01345",
"slug": "makanan-minuman",
"name": "Makanan & Minuman",
"description": "Makanan dan minuman",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=9",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.329Z",
"updatedAt": "2025-12-26T08:01:37.329Z"
},
{
"id": "a637ad1f-2600-4b6a-8200-4d8e9a2f4cc7",
"slug": "buku-alat-tulis",
"name": "Buku & Alat Tulis",
"description": "Buku, alat tulis, dan perlengkapan kantor",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=8",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.325Z",
"updatedAt": "2025-12-26T08:01:37.325Z"
},
{
"id": "dd08323f-8180-4863-8582-f77262ace9a5",
"slug": "mainan-hobi",
"name": "Mainan & Hobi",
"description": "Mainan dan perlengkapan hobi",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=7",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.322Z",
"updatedAt": "2025-12-26T08:01:37.322Z"
},
{
"id": "38f3b908-9bd0-4bd0-a38f-2c75f3f00607",
"slug": "otomotif",
"name": "Otomotif",
"description": "Sparepart dan aksesoris otomotif",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=6",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.319Z",
"updatedAt": "2025-12-26T08:01:37.319Z"
},
{
"id": "42f0dd0f-b6a8-47d2-83c0-4f0ac40e1ef1",
"slug": "olahraga-outdoor",
"name": "Olahraga & Outdoor",
"description": "Alat olahraga dan outdoor",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=5",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.314Z",
"updatedAt": "2025-12-26T08:01:37.314Z"
}
],
"pagination": {
"totalItems": 14,
"totalPages": 2,
"currentPage": 1,
"perPage": 10,
"hasNextPage": true,
"hasPrevPage": false
}
}Modified at 2025-12-30 03:45:44