6. Get Sub Category List | Toco - Omni Open API Documentations

Get Sub-Categories — Retrieve reference sub-categories for the selected category; returns a standard response envelope (array of sub-categories) for dependent dropdowns.

# Overview

Auth: --
Method: GET

# Path

https://partners-api.tocobagus.net/api/v1 /partner/reference/sub-categories

# Request

# Query Parameters

Name	Type	Required	Description
`categoryId`	string	❌	—

Required headers: None.

# Request Payload

Request payload: Not used for GET.

# Example Request

Curl Node.js Go Java

curl -X GET "http:///partner/reference/sub-categories?categoryId=%3CcategoryId%3E" \
  -H "Content-Type: application/json" \

const qs = new URLSearchParams({
  "categoryId": "<categoryId>"
});
const url = "http:///partner/reference/sub-categories" + (qs.toString() ? "?" + qs.toString() : "");
const res = await fetch(url, {
  method: "GET",
  headers: {}
});
const json = await res.json();
console.log(json);

qs := url.Values{}
qs.Set("categoryId", "<categoryId>")
u := "http:///partner/reference/sub-categories"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("GET", u, nil)

req.Header.Set("Content-Type","application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("http:///partner/reference/sub-categories?categoryId=%3CcategoryId%3E"))
    .header("Content-Type","application/json")
    
    .method("GET", java.net.http.HttpRequest.BodyPublishers.noBody())
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

# Responses

# Example Responses

200 OK

{
  "success": true,
  "message": "Sub-categories retrieved successfully",
  "data": [
    {
      "id": "3492767b-9e80-4eca-9405-e18ac7aa778b",
      "name": "Audio Intercom and Emergency Alerts"
    },
    {
      "id": "e8f9685e-a8b0-481a-863c-daef6dcfb490",
      "name": "Lock and Entry Management"
    },
    {
      "id": "66421bca-7f17-4e30-8ed5-e0f986adf8ac",
      "name": "RFID Access Systems"
    }
  ]
}

# Dictionary

None for this endpoint.

# Notes