You must be an Administrator, Project Assigner, or Activity Assigner to view other users. All users can view their own details as described here.

It is not possible to create, update or delete users with the API.

Show

Request

GET /users/#{user-id}.xml

Optional parameters

Specify include=rights to include user rights (i.e. permissions):

GET /users/#{user-id}.xml?include=rights

Response

Status: 200 OK

<user>
  <id type="integer">25</id>
  <name>walter</name>
  <first-name>Walter</first-name>
  <last-name>Smith</last-name>
  <active type="boolean">true</active>
  <code>WS</code>
  <email>walter@thelazymouse.com</email>
  <url>http://intranet/employees/ws</url>
  <created-at type="datetime">2007-03-30T20:35:27Z</created-at>
  <updated-at type="datetime">2008-01-07T02:19:09Z</updated-at>
  <!-- if include=rights -->
  <rights>
    <admin type="boolean">true</admin>
    <billing-contact type="boolean">true</billing-contact>
    <client-manager type="boolean">true</client-manager>
    <project-manager type="boolean">false</project-manager>
    <task-manager type="boolean">true</task-manager>
    <activity-manager type="boolean">true</activity-manager>
    <view-management-reports type="boolean">true</view-management-reports>
    <time-sheet-approver type="boolean">false</time-sheet-approver>
    <updated-at type="datetime">2008-01-06T17:48:33Z</updated-at>
  </rights>
</user>

List

Request

All users:

GET /users.xml

All active users:

GET /users/active.xml

All inactive users:

GET /users/inactive.xml

Optional parameters

Specify start and end to request a specific range of users. For example:

GET /users.xml?start=1&end=3

Response

Status: 200 OK

<users total="6" end="3" start="1">
  <user>
    ...
  </user>
  ...
</users>

Continue to Project Assignments...