Gallery Platform API
Reference

List a gallery's available works (public)

The gallery's opt-in available works — the browser-safe read surface. Authenticated with a `gpub_` publishable token; CORS-open. Price appears only where the gallery publishes it. Each work carries `availability` (`available` or `sold`); a held or reserved work reads `available`. Pass `include_sold=true` to also list sold works.

GET
/public/artworks

The gallery's opt-in available works — the browser-safe read surface. Authenticated with a gpub_ publishable token; CORS-open. Price appears only where the gallery publishes it. Each work carries availability (available or sold); a held or reserved work reads available. Pass include_sold=true to also list sold works.

Authorization

bearerAuth artworks:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: artworks:read

Query Parameters

include_sold?string

true: also list sold works, marked availability: "sold". Default false: available works only.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "artwork_id": "string",      "title": "string",      "artist_name": "string",      "year": -9007199254740991,      "medium": "string",      "dimensions_text": "string",      "height_cm": 0,      "width_cm": 0,      "depth_cm": 0,      "dimension_unit": "string",      "price_cents": -9007199254740991,      "currency": "string",      "cover_storage_path": "string",      "cover_image_url": "string",      "availability": "available"    }  ]}