Retrieve a Person

The result returned from a person search (see Search for Persons) is an Atom feed in which each entry contains a complete person record:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title type="text">Person lookup for &lt;em&gt;&lt;strong&gt;mail@example.com&lt;/strong&gt;&lt;/em&gt;</title>
  <author>
    <name>Escenic Content Engine</name>
  </author>
  <updated>2012-03-22T06:31:53.054Z</updated>
  <id>3d8d6fa0-8e35-4630-b02e-7865eace3441</id>
  <link rel="self" href="http://host-ip-address/webservice/escenic/person/lookup?email=mail@example.com" type="application/atom+xml"/>
  <entry xmlns:app="http://www.w3.org/2007/app" xmlns:metadata="http://xmlns.escenic.com/2010/atom-metadata" xmlns:dcterms="http://purl.org/dc/terms/">
    <id>http://host-ip-address/webservice/escenic/person/20</id>
    <link rel="self" href="http://host-ip-address/webservice/escenic/person/20" type="application/atom+xml; type=entry"/>
    <link rel="edit" href="http://host-ip-address/webservice/escenic/person/20" type="application/atom+xml; type=entry"/>
    <link rel="http://www.vizrt.com/types/relation/lock" href="http://host-ip-address/webservice/escenic/lock/person/20" type="application/atom+xml; type=entry"/>
    <dcterms:identifier>20</dcterms:identifier>
    <link href="http://host-ip-address/webservice/escenic/publication/publication-id/" rel="http://www.vizrt.com/types/relation/publication" type="application/atom+xml; type=entry" title="dev.nightly"/>
    <metadata:publication href="http://host-ip-address/webservice/escenic/publication/publication-id/" title="publication-title"/>
    <content type="application/vnd.vizrt.payload+xml">
      <vdf:payload xmlns:vdf="http://www.vizrt.com/types" model="http://host-ip-address/webservice/escenic/publication/test/model/com.escenic.person">
        <vdf:field name="com.escenic.username"/>
        <vdf:field name="com.escenic.firstName">
          <vdf:value>Firstname</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.surName">
          <vdf:value>Surname</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.occupation"/>
        <vdf:field name="com.escenic.address"/>
        <vdf:field name="com.escenic.postalcode"/>
        <vdf:field name="com.escenic.city"/>
        <vdf:field name="com.escenic.phonework"/>
        <vdf:field name="com.escenic.phonemobile"/>
        <vdf:field name="com.escenic.phoneprivate"/>
        <vdf:field name="com.escenic.emailaddress">
          <vdf:value>mail@example.com</vdf:value>
        </vdf:field>
      </vdf:payload>
    </content>
    <app:edited>2012-03-22T04:17:44.000Z</app:edited>
    <updated>2012-03-22T04:17:44.000Z</updated>
    <published>2012-03-22T04:17:44.000Z</published>
    <dcterms:created>2012-03-22T04:17:44.000Z</dcterms:created>
    <title type="text">Surname</title>
    <summary type="text">Firstname Surname</summary>
  </entry>
</feed>

Therefore, you probably don't need to explicitly retrieve person objects. You can do so if you wish, by following the self or edit link in each of the feed's entries, for example:

curl -u user:password http://host-ip-address/webservice/escenic/person/20

However, all you get back is the same information as a single Atom entry:

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:metadata="http://xmlns.escenic.com/2010/atom-metadata" xmlns:dcterms="http://purl.org/dc/terms/">
  <id>http://host-ip-address/webservice/escenic/person/20</id>
  <link rel="self" href="http://host-ip-address/webservice/escenic/person/20" type="application/atom+xml; type=entry"/>
  <link rel="edit" href="http://host-ip-address/webservice/escenic/person/20" type="application/atom+xml; type=entry"/>
  <link rel="http://www.vizrt.com/types/relation/lock" href="http://host-ip-address/webservice/escenic/lock/person/20" type="application/atom+xml; type=entry"/>
  <dcterms:identifier>20</dcterms:identifier>
  <link href="http://host-ip-address/webservice/escenic/publication/publication-id/" rel="http://www.vizrt.com/types/relation/publication" type="application/atom+xml; type=entry" title="dev.nightly"/>
  <metadata:publication href="http://host-ip-address/webservice/escenic/publication/publication-id/" title="publication-title"/>
  <content type="application/vnd.vizrt.payload+xml">
    <vdf:payload xmlns:vdf="http://www.vizrt.com/types" model="http://host-ip-address/webservice/escenic/publication/test/model/com.escenic.person">
      <vdf:field name="com.escenic.username"/>
      <vdf:field name="com.escenic.firstName">
        <vdf:value>Firstname</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.surName">
        <vdf:value>Surname</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.occupation"/>
      <vdf:field name="com.escenic.address"/>
      <vdf:field name="com.escenic.postalcode"/>
      <vdf:field name="com.escenic.city"/>
      <vdf:field name="com.escenic.phonework"/>
      <vdf:field name="com.escenic.phonemobile"/>
      <vdf:field name="com.escenic.phoneprivate"/>
      <vdf:field name="com.escenic.emailaddress">
        <vdf:value>mail@example.com</vdf:value>
      </vdf:field>
    </vdf:payload>
  </content>
  <app:edited>2012-03-22T04:17:44.000Z</app:edited>
  <updated>2012-03-22T04:17:44.000Z</updated>
  <published>2012-03-22T04:17:44.000Z</published>
  <dcterms:created>2012-03-22T04:17:44.000Z</dcterms:created>
  <title type="text">Surname</title>
  <summary type="text">Firstname Surname</summary>
</entry>