# ? home → help

Api, Presence

The presence service only supports one feature, which returns presence information available to the authenticated user.

Contents 1 Service 2 Parameters 3 Default 3.1 Returns 3.2 Example 3.3 See Also

[edit] Service

• Uri: presence.php
• Method: HTTP GET

[edit] Parameters

• No parameters required

[edit] Default

The default function returns presence information available to the authenticated user.

[edit] Returns

Returns an XML tree containing presence information for the user's friends/contacts etc.

[edit] Example

GET /api/presence.php

<PresenceList>
 <Person status="online">
  <since/>
  <userId>20</userId>
  <lastUpdate/>
  <id/>
  <creatorId/>
  <created/>
  <description/>
  <addyStreet/>
  <addyStreet2/>
  <addySuburb/>
  <addyCity/>
  <addyState/>
  <addyPostcode/>
  <addyCountry/>
  <phone/>
  <web/>
  <email/>
  <latitude/>
  <longitude/>
  <name/>
  <setAt>2006-07-30 20:23:00</setAt>
  <user>Bob</user>
  <userHasImage>T</userHasImage>
  <msgSince/>
  <msg/>
  <msnStatus>Offline</msnStatus>
  <msnName>Bobby</msnName>
  <msnMessage/>
  <msnSince>87:15:16</msnSince>
  <atHome/>
  <fullName>Bob Jones</fullName>
 </Person>
</PresenceList>

[edit] See Also

• Presence
• Api