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 > Partners
A partner provides artworks.
Retrieve partners by following the partners link from root.
curl -v "https://api.artsy.net/api/partners" -H "X-XAPP-Token: XAPP_TOKEN"
This endpoint accepts the following parameters.
Name | Value |
---|---|
user_id | Retrieve partners that a user has access to. |
partner_id | Combine with 'user_id' to check whether a user has access to this partner. |
The response is a paginated result with embedded partners.
Users can retrieve a specific partner by ID by rendering the "partner" link template from root.
curl -v "https://api.artsy.net/api/partners/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
Key | Target |
---|---|
self | The partner resource. |
profile | Partner profile. |
permalink | An external location on the artsy.net website. |
website | Official website. |
artworks | Partner artworks. |
artists | Partner artists. |
published_artworks | All published partner artworks. |
shows | Partner shows. |
{ "id": "4f99c7b793ab4b0001000179", "slug": "national-gallery-of-art-washington-dc", "created_at": "2012-04-26T22:09:59+00:00", "updated_at": "2024-12-11T09:26:59+00:00", "type": "Institution", "name": "National Gallery of Art, Washington, D.C.", "email": "", "region": "North America", "enforce_on_platform_transactions": null, "_links": { "self": { "href": "https://api.artsy.net/api/partners/4f99c7b793ab4b0001000179" }, "profile": { "href": "https://api.artsy.net/api/profiles/ngadc" }, "artworks": { "href": "https://api.artsy.net/api/artworks?partner_id=4f99c7b793ab4b0001000179" }, "artists": { "href": "https://api.artsy.net/api/artists?partner_id=4f99c7b793ab4b0001000179" }, "published_artworks": { "href": "https://api.artsy.net/api/artworks?partner_id=4f99c7b793ab4b0001000179&published=true" }, "partner_contacts": { "href": "https://api.artsy.net/api/partner_contacts?partner_id=4f99c7b793ab4b0001000179" }, "shows": { "href": "https://api.artsy.net/api/shows?partner_id=4f99c7b793ab4b0001000179" }, "permalink": { "href": "https://www.artsy.net/ngadc" }, "website": { "href": "http://www.nga.gov" } } }