Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.
If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.
Public API Documentation > Resources > Edition Sets
An edition set is usually a collection of prints created from the same matrix.
Editions are embedded within an artwork, but can also be retrieved individually by ID by rendering the "edition" link template from root.
curl -v "https://api.artsy.net/api/edition/{id}?artwork_id={artwork_id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| 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": "2019-04-24T12:51:27+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": null,
"sold": false,
"_links": {
"artwork": {
"href": "https://api.artsy.net/api/artworks/5035a0faf852da0002000781"
},
"self": {
"href": "https://api.artsy.net/api/editions/5097e5ebac8b8d0002000a07?artwork_id=5035a0faf852da0002000781"
}
}
}