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 > User Details

This User Details API is restricted to authorized applications and users with a valid user access token.

User Details API

While a user represents publicly available reference about a registered user account on Artsy, user details are the private portion of such information, including the user's e-mail address or phone number.

Retrieving User Details

Users can retrieve a specific user by following the "user_details" link from a user.

curl -v "https://api.artsy.net/api/user_details/{id}" -H "X-Access-Token: ACCESS_TOKEN"

User Details JSON Format

error: the server responded with status 404

Links

Key Target
self The profile resource.
user Link to the user information.
partners Link to partners this user has management access to.

Example

{
  "id" : "52fe4b28c94d114d36000001",
  "created_at" : "2014-02-14T16:58:17+00:00",
  "updated_at" : "2014-09-08T13:32:34+00:00",
  "type" : "User",
  "email" : "[email protected]",
  "birthday" : null,
  "phone" : null,
  "gender" : "female",
  "_links" : {
    "self" : {
      "href" : "https://api.artsy.net/api/user_details/52fe4b28c94d114d36000001"
    },
    "user" : {
      "href" : "https://api.artsy.net/api/user/52fe4b28c94d114d36000001"
    }
  }
}