API 2.0 Version 1.0
Photos.List
Returns a list of photos ordered with the most recent first.
Example
Arguments
limit optional
Maximum number of results to return. Default is 20 and maximum is 100.
page optional
Scan into the results by specifying a page number. Default is 1.
tags optional
Specifies if the tags element (which contains the contributors, works, etc) should be included in the results. If you only need high level information you can reduce overhead by not returning tags.
Allowed values are:
  • 0 - The tags element is not returned.
  • 1 (default) - The tags element is returned.
cid optional
By default the API returns data for the contributor associated with your account and you can ignore this parameter. If you have extended API permissions you can request data from other contributors by specifying the cid.
Response Elements
Element Description Empty Allowed? Cardinality?
photos
Contains 0 to many photo objects that match the request. The element also has attributes that describe the total number of items matching the request, the number of items returned per page, and the current page index of results.
yes 1
Sample Response
<photos page="1" max-per-page="20" total="10">
   <photo>
      <itemid>2040597</itemid>
      <owner>sdsymphony</owner>
      <date-added>2019-08-25T03:34:28</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
      <photoid>261372</photoid>
      <title>San Diego Symphony</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>1068973</itemid>
      <owner>sdsymphony</owner>
      <date-added>2013-01-04T02:13:15</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/149788/149788_150s.jpg</image>
      <photoid>149788</photoid>
      <title>Ray Nowak, trumpet</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists>
            <contributor>
               <cid>5130076</cid>
               <first-last>Ray Nowak</first-last>
               <last-first>Nowak, Ray</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/149788/149788_150s.jpg</image>
               <photoid>149788</photoid>
            </contributor>
         </artists>
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>1068971</itemid>
      <owner>sdsymphony</owner>
      <date-added>2013-01-04T02:05:54</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/149786/149786_150s.jpg</image>
      <photoid>149786</photoid>
      <title>AJ Niles</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists>
            <contributor>
               <cid>5171998</cid>
               <first-last>AJ NILES</first-last>
               <last-first>NILES, AJ</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/149786/149786_150s.jpg</image>
               <photoid>149786</photoid>
            </contributor>
         </artists>
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>1068964</itemid>
      <owner>sdsymphony</owner>
      <date-added>2013-01-04T01:49:33</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/149779/149779_150s.jpg</image>
      <photoid>149779</photoid>
      <title>Anna Skalova, violin</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists>
            <contributor>
               <cid>5171996</cid>
               <first-last>Anna Skalova</first-last>
               <last-first>Skalova, Anna</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/206998/206998_150s.jpg</image>
               <photoid>206998</photoid>
            </contributor>
         </artists>
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>858222</itemid>
      <owner>sdsymphony</owner>
      <date-added>2011-10-10T18:54:21</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/122824/122824_150s.jpg</image>
      <photoid>122824</photoid>
      <title />
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>845011</itemid>
      <owner>sdsymphony</owner>
      <date-added>2011-09-08T21:31:27</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/121171/121171_150s.jpg</image>
      <photoid>121171</photoid>
      <title>Jahja Ling, Music Director</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>785143</itemid>
      <owner>sdsymphony</owner>
      <date-added>2011-04-14T21:08:59</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/113704/113704_150s.jpg</image>
      <photoid>113704</photoid>
      <title>Music Director Jahja Ling and San Diego Symphony</title>
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues>
            <venue>
               <venueid>4</venueid>
               <name>Copley Symphony Hall</name>
               <hall />
               <country>United States</country>
               <region>California</region>
               <city>San Diego</city>
               <postalcode>92101</postalcode>
               <geo>
                  <lat>32.717813</lat>
                  <lon>-117.157871</lon>
               </geo>
            </venue>
         </venues>
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>785139</itemid>
      <owner>sdsymphony</owner>
      <date-added>2011-04-14T21:06:41</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/113702/113702_150s.jpg</image>
      <photoid>113702</photoid>
      <title>Summer Pops site</title>
      <description>This is our Summer Pops site from July-September. It is located at Embacadero Marina Park South.</description>
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues>
            <venue>
               <venueid>2636</venueid>
               <name>Embarcadero Marina Park South</name>
               <hall />
               <country>United States</country>
               <region>California</region>
               <city>San Diego</city>
               <postalcode>92101</postalcode>
               <geo>
                  <lat>32.705074</lat>
                  <lon>-117.163973</lon>
               </geo>
            </venue>
         </venues>
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>741346</itemid>
      <owner>sdsymphony</owner>
      <date-added>2011-01-13T00:44:34</date-added>
      <date-created>2009-11-05T00:00:00</date-created>
      <image>https://s3.amazonaws.com/photos.instantencore.com/107451/107451_150s.jpg</image>
      <photoid>107451</photoid>
      <title>San Diego Symphony</title>
      <description>Newest photo featuring music director Jahja Ling and some members of San Diego Symphony.</description>
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors />
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
   <photo>
      <itemid>157057</itemid>
      <owner>maestro</owner>
      <date-added>2009-01-28T20:24:30</date-added>
      <date-created />
      <image>https://s3.amazonaws.com/photos.instantencore.com/4633/4633_150s.jpg</image>
      <photoid>4633</photoid>
      <title />
      <description />
      <tags>
         <presenters />
         <composers />
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <works />
         <venues />
         <instruments />
         <form-genres />
         <periods />
      </tags>
   </photo>
</photos>