List colors

Use the catalog to build your own color picker. To offer only some brands or colors, show only those in your interface.

curl "https://api.paintvisualizer.ai/v1/colors?brand=sherwin-williams&limit=2" \
  -H "Authorization: Bearer pv_your_key"

brandstring

A brand slug. Leave it out to list every brand.

qstring

Search by color name or code. Search results come back on one page.

limitnumber

Colors per page, from 1 to 100. The default is 50.

cursorstring

The next_cursor value from the previous page.

{
  "data": [
    {
      "brand": "sherwin-williams",
      "brand_name": "Sherwin-Williams",
      "name": "Agreeable Gray",
      "code": "SW 7029",
      "hex": "#D1CBC1",
      "family": "gray",
      "lrv": 60,
      "interior": true,
      "exterior": true
    }
  ],
  "next_cursor": "07f1b7c6..."
}

Pass next_cursor as cursor to get the next page. It is null on the last page.