# 8. Search Brands

Get Reference Brands — Search brand references with optional pagination; returns a standard response envelope (list of brands + total/pagination).

# Overview

Auth: --
Method: GET

# Path

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

# Request

# Query Parameters

Name	Type	Required	Description
`q`	string	❌	Search Keywords (Min 2 Chars)
`page`	integer	❌	—
`limit`	integer	❌	—

Required headers: None.

# Request Payload

Request payload: Not used for GET.

# Example Request

Curl Node.js Go Java

curl -X GET "http:///partner/reference/brands?q=%3Cq%3E&page=%3Cpage%3E&limit=%3Climit%3E" \
  -H "Content-Type: application/json" \

const qs = new URLSearchParams({
  "q": "<q>",
  "page": "<page>",
  "limit": "<limit>"
});
const url = "http:///partner/reference/brands" + (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("q", "<q>")
qs.Set("page", "<page>")
qs.Set("limit", "<limit>")
u := "http:///partner/reference/brands"
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/brands?q=%3Cq%3E&page=%3Cpage%3E&limit=%3Climit%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": "Brands retrieved successfully",
  "data": [
    {
      "id": "0b9889ed-e129-4ba1-a5c1-9fce5212ec25",
      "name": "Supreme"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}

422 Unprocessable Entity

{
  "success": false,
  "error": {
    "code": "VAL_001",
    "message": "Validation failed",
    "details": {
      "timestamp": "2025-09-17T10:03:33.681Z",
      "hint": "Please check your request data and try again",
      "context": {
        "validationErrors": {
          "q": "Search query must be at least 2 characters long"
        }
      }
    }
  },
  "requestId": "3e22c557-f831-4d9e-abfc-3aeb35aad7c2"
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.