Get lowest prices by SKU

GET 
/partner/lowest/:sku

Returns the lowest listing prices for each size of a product, broken down by listing type. Results are cached for 60 seconds.

Size map keys per size:

• ask — lowest ask listing price
• pre-order — lowest pre-order price
• pre_verified — lowest R2S (pre-verified) price
• pre_verified_mint — lowest R2S price with no defects

Sizes with no active listings will not have a key in the map.

Request

Responses

200

Lowest prices by size

400

SKU not found — no product exists for this SKU.

This response is cached for up to 5 minutes. After a SKU starts returning 0009, a product created for it may continue to return 0009 for up to 300 seconds. This is a change from previous behaviour, where a not-found was never cached. Successful responses are unaffected (still 60 seconds).

POST /partner/lowest/bulk consults the same not-found cache and is subject to the same 300 seconds — switching endpoints will not make a newly created SKU visible any sooner. The cache is per-server-instance and requests are load-balanced, so two calls made back to back can disagree; all instances converge within 300 seconds. If you need certainty before then, retry after the 300 seconds rather than hot-looping either route.

500

Internal server error