Skip to main content
GET
/
api
/
seller
/
v1
/
brands
List token-authorized brands
curl --request GET \
  --url https://app.openlight.tech/api/seller/v1/brands \
  --header 'Authorization: Bearer <token>'
{
  "brands": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "logo_url": "<string>",
      "website": "<string>",
      "product_count": 123,
      "amazon_regions": [
        "<string>"
      ],
      "amazon_marketplaces": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}
Use this endpoint to list brands authorized for the current seller or operator token owner. Operator accounts are seller-side roles and can only see the brands they are authorized to access. List endpoints use cursor pagination: limit defaults to 25 and cannot exceed 100; pass the previous response’s next_cursor as cursor to read the next page. When there are no more results, next_cursor is null. Response fields:
  • id: Brand ID.
  • name: Brand name.
  • description: Brand description; may be omitted.
  • logo_url: Brand logo image URL; may be omitted.
  • website: Brand website URL; may be omitted.
  • status: Brand status.
  • product_count: Number of currently visible products; may be omitted.
  • amazon_regions: Amazon country/region codes where the brand currently has active products; may be omitted.
  • amazon_marketplaces: Amazon marketplace domains, such as amazon.com or amazon.co.uk; may be omitted.
  • partnership_status: The current token owner’s partnership status with the brand. Seller-side integrations usually do not use this field to determine authorization.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:25

每页返回数量,默认 25,最大 100。Number of items per page; defaults to 25 and maxes out at 100.

Required range: x <= 100
cursor
string

上一页响应返回的下一页游标。Cursor returned as next_cursor by the previous page.

Response

Authorized brands

brands
object[]
required

品牌列表。List of brands.

next_cursor
string | null
required

下一页游标;为 null 表示没有更多结果。Cursor for the next page; null means there are no more results.