Public API Documentation > Resources > Partners
A partner provides artworks.
Retrieve partners by following the partners link from root.
curl -v "https://stagingapi.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://stagingapi.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-08-08T09:06:36+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://stagingapi.artsy.net/api/partners/4f99c7b793ab4b0001000179"
},
"profile": {
"href": "https://stagingapi.artsy.net/api/profiles/ngadc"
},
"artworks": {
"href": "https://stagingapi.artsy.net/api/artworks?partner_id=4f99c7b793ab4b0001000179"
},
"artists": {
"href": "https://stagingapi.artsy.net/api/artists?partner_id=4f99c7b793ab4b0001000179"
},
"published_artworks": {
"href": "https://stagingapi.artsy.net/api/artworks?partner_id=4f99c7b793ab4b0001000179&published=true"
},
"partner_contacts": {
"href": "https://stagingapi.artsy.net/api/partner_contacts?partner_id=4f99c7b793ab4b0001000179"
},
"shows": {
"href": "https://stagingapi.artsy.net/api/shows?partner_id=4f99c7b793ab4b0001000179"
},
"permalink": {
"href": "https://staging.artsy.net/ngadc"
},
"website": {
"href": "http://www.nga.gov"
}
}
}