Public API Documentation > Resources > Users

This API endpoint requires a valid user access token.

Users API

A user represents a registered account on Artsy.

Retrieving a User

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

curl -v "{id}" -H "X-Access-Token: ACCESS_TOKEN"

Retrieving Current User

Retrieve the currently authenticated user by following the current_user link from root.

curl -v "" -H "X-Access-Token: ACCESS_TOKEN"

The response will be a 302 redirect to a "users" link with the current user ID.

User JSON Format

error: the server responded with status 404


Key Target
self The profile resource.
profile Link to the user's public profile.
user_details Link to user's details.


  "id" : "52fe4b28c94d114d36000001",
  "name" : "Joe Person",
  "_links" : {
    "self" : {
      "href" : ""
    "profile" : {
      "href" : "http://localhost:3000/api/profiles/52fe4b2ac94d114d36000005"
    "user_details" : {
      "href" : "http://localhost:3000/api/user_details/52fe4b28c94d114d36000001"