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:..."

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:..."

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.


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": "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": [
  "_links": {
    "thumbnail": {
      "href": ""
    "image": {
      "href": "{image_version}.jpg",
      "templated": true
    "self": {
      "href": ""
    "permalink": {
      "href": ""
    "website": {
      "href": ""
    "cover_image": {
      "href": ""
    "owner": {
      "href": ""