Gallery Platform API
Reference

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

Path Parameters

id*string

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",      "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,      "metadata": {        "property1": "string",        "property2": "string"      },      "created_at": "string",      "updated_at": "string"    }  ]}