Skip to content
Dials Docs

Listings

Live marketplace offers, matched to catalogue models where possible.

List listings

GET/listings

A page of marketplace listings, watches currently offered for sale by the providers this catalogue tracks. Scope to one model with modelId, convert prices with currency.

Query Parameters

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

Model slug

brand
string

Brand slug

provider
string

Provider slug

condition
string | null
Values
NEWUNWORNVERY_GOODGOODFAIR
availability
string | null
Values
IN_STOCKON_REQUESTNEED_SOURCEnull
status
string & unknown

Lifecycle: ACTIVE, RESERVED, or DELISTED

minPriceUSD
integer | null·min 0
maxPriceUSD
integer | null·min 0
unmatched
boolean | null

Only listings with no linked model

includeDelisted
boolean | null

Include listings the delist sweep marked gone (hidden by default)

sort
string·default newest
Values
newestprice_ascprice_desc
currency
string & unknown

Also return priceUSD converted into this currency (USD is a no-op)

Responses

Asking-price summary for one model

GET/listings/stats

How many watches of one model are currently offered, and the lowest, median and highest price being ASKED for them. Asking prices as advertised by the tracked providers: not transaction prices, and not a valuation. Convert with currency.

Query Parameters

modelRequired
string

Model slug

brandRequired
string

Brand slug

currency
string & unknown

Return the figures converted into this currency (USD is a no-op)

Responses

Get a single listing

GET/listings/{id}

One listing by id, with its price, condition, provider and the catalogue model it was matched to (when it was matched to one).

Path Parameters

idRequired
string
Exampleclx123

Responses