Skip to content
Dials Docs

Brands

Watch houses, and the series inside them.

List brands

GET/brands

A page of watch houses, each with its series and model counts and one representative picture. Filter with q, order by name or catalogue depth with sort.

Query Parameters

page
integer·min 1·default 1
Example1
pageSize
integer·min 1·max 100·default 24
Example24
q
string
sort
string·default name_asc
Values
name_ascmodels_desc

Responses

List the highlighted brands

GET/brands/highlighted

The houses the home page leads with, in editorial order. A fixed, hand-picked row rather than a ranking, so it does not reshuffle when a spider runs.

Responses

Get a brand by slug

GET/brands/{slug}

One brand by its URL slug (rolex, patek-philippe). Slugs are stable and are what every other brand-scoped path takes. Includes stats, the shape of the brand's own catalogue: year and diameter ranges, case materials, movement count and how many of its watches are currently listed.

Path Parameters

slugRequired
string
Examplerolex

Responses

List a brand's series

GET/brands/{brandSlug}/series

The series (collections) inside one brand (Submariner, Nautilus), each with its model count and a lead model to illustrate it.

Path Parameters

brandSlugRequired
string
Examplerolex

Query Parameters

page
integer·min 1·default 1
Example1
pageSize
integer·min 1·max 100·default 24
Example24
q
string

Responses

Get a series by brand + series slug

GET/brands/{brandSlug}/series/{seriesSlug}

One series, addressed by its brand and its own slug. Includes the parent brand, a lead model, and stats: the year and diameter ranges, case materials, movement count and current listing count derived from the series' own references.

Path Parameters

brandSlugRequired
string
Examplerolex
seriesSlugRequired
string
Examplesubmariner

Responses