Documentation > Resources > Profiles

Profiles API

A public profile provides information about a partner or a user.

Retrieving Profiles

Retrieve profiles by following the profiles link from root.

curl -v "https://api.artsy.net/api/profiles" -H "X-XAPP-Token:..."

The response is a paginated result with embedded profiles.

Retrieving a Profile

Users can retrieve a specific profile by ID by rendering the "profile" link template from root.

curl -v "https://api.artsy.net/api/profiles/{id}" -H "X-XAPP-Token:..."

Profile JSON Format

Key Description
id Unique id.
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
handle Globally unique handle.
location Location.
description Description.
image_versions Available image versions.

Links

Key Target
self The profile resource.
permalink An external location on the artsy.net website.
owner Profile owner (user, fair, etc).
cover_image A cover image.
image:self Curied image location.
website Official website.

Example

{
  "id": "5159dac69a608324390001e5",
  "created_at": "2013-04-01T19:06:46+00:00",
  "updated_at": "2016-02-19T19:26:09+00:00",
  "handle": "ngadc",
  "location": "",
  "description": "The National Gallery of Art preserves, collects, exhibits, and fosters understanding of works of art at the highest possible museum and scholarly standards.",
  "image_versions": [
    "large",
    "square140",
    "square",
    "untouched-png"
  ],
  "_links": {
    "thumbnail": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/YFzRuHBJA6lpANqDum6oCw/square.jpg"
    },
    "image": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/YFzRuHBJA6lpANqDum6oCw/{image_version}.jpg",
      "templated": true
    },
    "self": {
      "href": "https://api.artsy.net/api/profiles/5159dac69a608324390001e5"
    },
    "permalink": {
      "href": "http://www.artsy.net/ngadc"
    },
    "website": {
      "href": "http://www.nga.gov/"
    },
    "cover_image": {
      "href": "https://api.artsy.net/api/images/53bea7f972616931b4230000"
    },
    "owner": {
      "href": "https://api.artsy.net/api/partners/4f99c7b793ab4b0001000179"
    }
  }
}