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

Key Description
id Unique id.
slug Slug
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
type Type.
name Name.
email Contact email.
region Region.

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": "2017-10-07T09:55:56+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"
    }
  }
}