Public API 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 "" -H "X-XAPP-Token: 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 "{id}" -H "X-XAPP-Token: XAPP_TOKEN"

Profile JSON Format

error: the server responded with status 404


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


  "id": "5159dac69a608324390001e5",
  "created_at": "2013-04-01T19:06:46+00:00",
  "updated_at": "2022-02-16T22:02:30+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": [
  "_links": {
    "thumbnail": {
      "href": ""
    "image": {
      "href": "{image_version}.jpg",
      "templated": true
    "self": {
      "href": ""
    "permalink": {
      "href": ""
    "website": {
      "href": ""
    "cover_image": {
      "href": ""
    "owner": {
      "href": ""