Documentation > Resources > Partners

Partners API

A partner provides artworks.

Retrieving Partners

Retrieve partners by following the partners link from root.

curl -v "https://api.artsy.net/api/partners" -H "X-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.

Retrieving a Partner

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:..."

Partner JSON Format

error: missing models

Links

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.

Example

{
  "id": "4f99c7b793ab4b0001000179",
  "slug": "national-gallery-of-art-washington-dc",
  "created_at": "2012-04-26T22:09:59+00:00",
  "updated_at": "2018-07-06T16:10:03+00:00",
  "type": "Institution",
  "name": "National Gallery of Art, Washington, D.C.",
  "email": "",
  "region": "North America",
  "_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": "http://www.artsy.net/ngadc"
    },
    "website": {
      "href": "http://www.nga.gov"
    }
  }
}