Documentation > Resources > Edition Sets

Editions API

An edition set is usually a collection of prints created from the same matrix.

Retrieving an Edition

Editions are embedded within an artwork, but can also be retrieved individually by ID by rendering the "edition" link template from root.

curl -v "{id}?artwork_id={artwork_id}" -H "X-XAPP-Token:..."

Edition JSON Format

Key Description
id Unique id.
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
editions Humanly readable edition text.
size Number of works in this edition.
available_editions Available editions in an array format, eg. ['1', 2, '3-9'].
artist_proofs Number of artist proofs produced.
prototypes Prototypes, typically used in design objects.
can_acquire True when the edition can be acquired from Artsy via e-commerce.
sale_message Purchasing information, which may include price.
sold True if the artwork has been sold.


Key Target
self The artwork resource.
artwork Artwork corresponding to the edition.


  "id": "5097e5ebac8b8d0002000a07",
  "created_at": "2012-11-05T16:14:35+00:00",
  "updated_at": "2012-11-05T16:14:54+00:00",
  "dimensions": {
    "in": {
      "text": "17 11/16 in",
      "height": 17.6875,
      "width": null,
      "depth": null,
      "diameter": null
    "cm": {
      "text": "44.9 cm",
      "height": 44.9,
      "width": null,
      "depth": null,
      "diameter": null
  "editions": "",
  "size": null,
  "available_editions": null,
  "artist_proofs": null,
  "prototypes": null,
  "can_acquire": false,
  "sale_message": "Not for sale",
  "sold": false,
  "_links": {
    "artwork": {
      "href": ""
    "self": {
      "href": ""