Read Person Portraits

This example request illustrates how to read the list of portrait descriptions that are linked to a person.

JSON

Request

GET /platform/tree/persons/KWCR-JWS/portraits
Accept: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+json
X-processing-time: 3
Etag: "1543638712000"
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/KWCR-JWS/portraits
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
  "persons" : [ ],
  "sourceDescriptions" : [ {
    "id" : "904106",
    "mediaType" : "image/jpeg",
    "about" : "https://familysearch.org/photos/images/TH-501-4202-21-3/dist.jpg?ctx=ArtCtxPublic",
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "version" : "123456789",
    "links" : {
      "image-icon" : {
        "href" : "https://familysearch.org/photos/images/TH-501-4202-21-3/thumb64.jpg?ctx=ArtCtxPublic"
      },
      "artifact" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/KWCR-JWS/portrait?flag=fsh"
      },
      "image" : {
        "href" : "https://familysearch.org/photos/images/TH-501-4202-21-3/dist.jpg?ctx=ArtCtxPublic"
      },
      "image-thumbnail" : {
        "href" : "https://familysearch.org/photos/images/TH-501-4202-21-3/thumb200.jpg?ctx=ArtCtxPublic"
      }
    },
    "sources" : [ {
      "descriptionId" : "3745023"
    } ]
  } ]
}

XML

Request

GET /platform/tree/persons/KWCR-JWS/portraits
Accept: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+xml
X-processing-time: 3
Etag: "1543638712000"
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/KWCR-JWS/portraits
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <sourceDescription about="https://familysearch.org/photos/images/TH-501-4202-21-3/dist.jpg?ctx=ArtCtxPublic" mediaType="image/jpeg" resourceType="http://gedcomx.org/DigitalArtifact" version="123456789" id="904106">
        <link rel="image" href="https://familysearch.org/photos/images/TH-501-4202-21-3/dist.jpg?ctx=ArtCtxPublic"/>
        <link rel="image-icon" href="https://familysearch.org/photos/images/TH-501-4202-21-3/thumb64.jpg?ctx=ArtCtxPublic"/>
        <link rel="image-thumbnail" href="https://familysearch.org/photos/images/TH-501-4202-21-3/thumb200.jpg?ctx=ArtCtxPublic"/>
        <link rel="artifact" href="https://api.familysearch.org/platform/tree/persons/KWCR-JWS/portrait?flag=fsh"/>
        <source descriptionId="3745023"/>
    </sourceDescription>
</gedcomx>