Gallery Platform API
ReferenceGalleryArtworksIdFormats

List artwork formats

Lists an artwork's sellable formats/variants (sizes, papers, framings), each with its own dimensions, edition size, stock, and membership-gated price. A read-only key sees a format's price only when the work is public-priced.

GET
/gallery/artworks/{id}/formats

Lists an artwork's sellable formats/variants (sizes, papers, framings), each with its own dimensions, edition size, stock, and membership-gated price. A read-only key sees a format's price only when the work is public-priced.

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

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/gallery/artworks/{id}/formats"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "artwork_id": "1a900bf9-a284-4c99-a359-1f6b482d475f",      "label": "string",      "height_cm": 0,      "width_cm": 0,      "depth_cm": 0,      "dimension_unit": "in",      "medium": "string",      "edition_size": -9007199254740991,      "stock_quantity": -9007199254740991,      "availability_state": "available",      "price_cents": -9007199254740991,      "currency": "string",      "position": -9007199254740991,      "created_at": "string",      "updated_at": "string"    }  ]}

List artwork activity timeline GET

Lists an artwork's activity timeline (added, moved, price changed, consigned, ownership, interest, interactions), newest first. Appended automatically as the work changes.

Create an artwork format POST

Adds a sellable format/variant to an artwork, appended to the end. A supplied price writes the gated pricing sibling. Rejected on an edition umbrella (only its copies or a standalone work are sellable).