Browse all documentation

List brands

List active brands owned by the account in creation order, oldest first.

GET/api/v1/brandsread

Call 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"
  }
}
FieldTypeDescription
iduuidIdentifier for requests scoped to this brand.
namestringSaved name of the brand.
domainstring | nullWebsite domain configured for the brand.
locationstring | nullLocation recorded for the brand.
regionsstring[]Country settings enabled for this brand.
languagesstring[]Languages configured for the brand.
createdAtdatetimeBrand 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 the Retry-After delay 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.