Skip to content

Brands endpoint

GET /api/v1/brands

Returns every active brand in the tenant, paginated (default 15 per page, max 100, alphabetical by name). Unlike the toplist endpoints, this one is not scoped to your specific site. It returns every active brand across the whole tenant account, including brands that may never appear on your site's toplists. Use it if you need the full brand catalog independent of any specific toplist (for example, to look up a brand your own system already knows about by ID), but don't assume the result set matches "brands visible on my site."

This is not the same shape as the brand embedded in each toplist item (see Toplists endpoints), and it's not a strict superset, so don't assume you can swap one for the other without checking field-by-field. It adds fields the embedded brand doesn't have, most notably the brand's full offers array (with each offer's trackers nested inside it), but it also drops at least one field the embedded brand does have: classificationTypes isn't returned by this endpoint at all. If you're already consuming toplists and only need what's already embedded there, you likely don't need this endpoint at all.

One inconsistency worth knowing about if you use both endpoints: the bonus/offer fields here use camelCase (hasFreeSpin, bonusWageringRequirement, bonusCode, minimumDeposit, and so on), while the equivalent fields on an offer embedded inside a toplist item use snake_case (has_free_spins, bonus_wagering_requirement, bonus_code, minimum_deposit, ...). Same concepts, different casing depending on which endpoint you hit. Don't write one shared parser expecting identical field names from both.

This endpoint wraps its payload in the same {"data": [...], "links": {...}, "meta": {...}} envelope as the toplist listing endpoint: see the response-wrapping note on Toplists endpoints.