TBBNMerchantDocs
Available

Catalog

get/v1/catalog/categories

List all top-level categories in the taxonomy

curl -X GET https://api.tbbnetwork.com/v1/catalog/categories \
  -H "Authorization: Bearer sk_sandbox_..." \

Response (200)

Example 200 response
[
  "value"
]
get/v1/catalog/categories/{category}/subcategories

List subcategories under a category

curl -X GET https://api.tbbnetwork.com/v1/catalog/categories/{category}/subcategories \
  -H "Authorization: Bearer sk_sandbox_..." \

Parameters

categorypathrequired

Response (200)

Example 200 response
[
  "value"
]

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}
get/v1/catalog/brands

List brands, optionally scoped to a category and/or subcategory

curl -X GET https://api.tbbnetwork.com/v1/catalog/brands \
  -H "Authorization: Bearer sk_sandbox_..." \

Parameters

categoryqueryoptional
subcategoryqueryoptional

Response (200)

Example 200 response
[
  "value"
]

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}