Get Categories
Prod Env
https://v1.dev.bukalombok.com
Prod Env
https://v1.dev.bukalombok.com
GET
/v1/categories
API Documentation: Get Categories
Endpoint
URL FULL
ROOT categories
GET /v1/categoriesCatatan: 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/categories'Response Response Example
200 - Success - Success
{
"meta": {
"success": true,
"status": 200,
"message": "Berhasil mengambil kategori"
},
"data": [
{
"id": "21c65bab-74aa-4c36-b3db-2b848166171c",
"slug": "kesehatan-kecantikan",
"name": "Kesehatan & Kecantikan",
"description": "Produk kesehatan dan kecantikan",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=4",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.311Z",
"updatedAt": "2025-12-26T08:01:37.311Z"
},
{
"id": "c47cc334-2a78-461e-96ac-6ff31cbd94e7",
"slug": "rumah-tangga",
"name": "Rumah Tangga",
"description": "Kebutuhan rumah tangga",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=3",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.307Z",
"updatedAt": "2025-12-26T08:01:37.307Z"
},
{
"id": "3f302660-2d31-4228-b10f-8242f12ffea4",
"slug": "fashion-pakaian",
"name": "Fashion & Pakaian",
"description": "Pakaian dan fashion terbaru",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=2",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.301Z",
"updatedAt": "2025-12-26T08:01:37.301Z"
},
{
"id": "c07e285c-de72-45a5-b467-4695ecdc632f",
"slug": "elektronik-gadget",
"name": "Elektronik & Gadget",
"description": "Produk elektronik dan gadget terkini",
"status": "PUBLISHED",
"image": "https://picsum.photos/300/200?random=1",
"parentId": null,
"createdAt": "2025-12-26T08:01:37.292Z",
"updatedAt": "2025-12-26T08:01:37.292Z"
}
],
"pagination": {
"totalItems": 14,
"totalPages": 2,
"currentPage": 2,
"perPage": 10,
"hasNextPage": false,
"hasPrevPage": true
}
}Modified at 2025-12-31 01:03:28