List an artwork's waitlist
Lists the collectors waiting to be notified when an artwork is available again (the public waitlist CTA's demand signal), newest first. Entries flip to `notified` when the back-in-stock notification goes out.
Lists the collectors waiting to be notified when an artwork is available again (the public waitlist CTA's demand signal), newest first. Entries flip to notified when the back-in-stock notification goes out.
Authorization
bearerAuth artworks:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read
Path Parameters
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "data": [ { "id": "string", "artwork_id": "string", "contact_id": "string", "status": "waiting", "notified_at": "string", "created_at": "string" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}Search artworks by visual description GET
Returns artworks whose cover image best matches a natural-language description of a look (subject, palette, mood), most similar first. This is the visual arm — pair it with the metadata artwork search for artist/status/price. Empty until covers are indexed.
Get the gallery's branding GET
Returns the gallery's branding (logo, accent color, font, footer, caption defaults). Falls back to built-in defaults when unset.