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 > Users
This API endpoint requires a valid user access token.
A user represents a registered account on Artsy.
Users can retrieve a specific user by rendering the "user" link template from root.
curl -v "https://api.artsy.net/api/users/{id}" -H "X-Access-Token: ACCESS_TOKEN"
Retrieve the currently authenticated user by following the current_user link from root.
curl -v "https://api.artsy.net/api/current_user" -H "X-Access-Token: ACCESS_TOKEN"
The response will be a 302 redirect to a "users" link with the current user ID.
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" : "https://api.artsy.net/api/users/52fe4b28c94d114d36000001"
},
"profile" : {
"href" : "http://localhost:3000/api/profiles/52fe4b2ac94d114d36000005"
},
"user_details" : {
"href" : "http://localhost:3000/api/user_details/52fe4b28c94d114d36000001"
}
}
}