List brands
List active brands owned by the account in creation order, oldest first.
GET
/api/v1/brandsreadCall the corresponding list_brands MCP tool with JSON arguments. Supply brandId and other path values as named arguments when the endpoint has them.
Request details
Required scope: A valid read or write token.
Request example
curl --request GET \
--url "https://searchseal.com/api/v1/brands" \
--header "Authorization: Bearer $SEARCHSEAL_TOKEN"Response fields
Response body example
{
"items": [
{
"id": "b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70",
"name": "Example Villas",
"domain": "example.com",
"location": "Ubud, Bali",
"regions": [
"id",
"au"
],
"languages": [
"en",
"id"
],
"createdAt": "2026-08-01T09:30:00.000Z"
}
],
"meta": {
"generatedAt": "2026-09-26T08:15:02.114Z",
"timeZone": "Asia/Jakarta"
}
}| Field | Type | Description |
|---|---|---|
id | uuid | Identifier for requests scoped to this brand. |
name | string | Saved name of the brand. |
domain | string | null | Website domain configured for the brand. |
location | string | null | Location recorded for the brand. |
regions | string[] | Country settings enabled for this brand. |
languages | string[] | Languages configured for the brand. |
createdAt | datetime | Brand creation timestamp. |
Successful REST responses from this endpoint include the shown meta fields. Read about data-through dates.
Possible errors
401 unauthorized— Authentication failed because the token is absent, unrecognized or revoked.403 forbidden— Account access or token permissions do not allow this request. Check the message for the cause.429 rate_limited— A quota was reached or could not be checked. Wait theRetry-Afterdelay before retrying.500 server_error— The server failed to complete the operation.
For the shared error format, see status codes, quotas and retries. Next endpoint: Get brand.