viewa/docs
API Reference

Get a material set

GET
/material-sets/{ref}

Fetch one material set by public id or by a SKU you have registered for it. Set membership is not returned — read a product slot's materials to get the expanded list.

Authorization

AuthorizationBearer <token>

Publishable key (browser-safe), sent as Authorization: Bearer pk_…. This is the lower API-key tier and is sufficient for browser-safe routes that require the pk tier. Requests using a publishable key are additionally validated against the key's domain allowlist via the Origin header. Used for upload, areas, renders, polling, catalog reads, and history (history additionally requires a visitor token).

In: header

Path Parameters

ref*string

Either a set_… public id or a SKU registered for a material set on your instance, resolved by the same rules as the product ref.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/material-sets/set_Qa1Zn8VtR3mKp0LcXw6B"
{  "id": "set_Qa1Zn8VtR3mKp0LcXw6B",  "name": "Blockout Collection",  "description": "string"}