User Resource¶

Name	`user`
URI	`/api/users/{username}/`
Description	Provides information on registered users. If a user’s profile is private, the fields `email`, `first_name`, `last_name`, and `fullname` will be omitted for non-staff users.
HTTP Methods	GET - Retrieve information on a registered user.
Parent Resource	User List Resource
Child Resources	Watched List Resource
Anonymous Access	Yes, if anonymous site access is enabled

Fields¶

Field	Type	Description
avatar_url	String	The URL for an avatar representing the user.
email	String	The user’s e-mail address
first_name	String	The user’s first name.
fullname	String	The user’s full name (first and last).
id	Integer	The numeric ID of the user.
last_name	String	The user’s last name.
url	String	The URL to the user’s page on the site. This is deprecated and will be removed in a future version.
username	String	The user’s username.

Links¶

Name	Method	Resource
self	GET	User Resource
watched	GET	Watched List Resource

HTTP GET¶

Retrieve information on a registered user.

This mainly returns some basic information (username, full name, e-mail address) and links to that user’s root Watched Items resource, which is used for keeping track of the groups and review requests that the user has “starred”.

Errors¶

Examples¶

application/vnd.reviewboard.org.user+json¶

{
  "stat": "ok", 
  "user": {
    "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61", 
    "email": "admin@example.com", 
    "first_name": "Admin", 
    "fullname": "Admin User", 
    "id": 1, 
    "last_name": "User", 
    "links": {
      "self": {
        "href": "http://reviews.example.com/api/users/admin/", 
        "method": "GET"
      }, 
      "watched": {
        "href": "http://reviews.example.com/api/users/admin/watched/", 
        "method": "GET"
      }
    }, 
    "url": "/users/admin/", 
    "username": "admin"
  }
}

application/vnd.reviewboard.org.user+xml¶

<?xml version="1.0" encoding="utf-8"?>
<rsp>
 <stat>ok</stat>
 <user>
  <username>admin</username>
  <first_name>Admin</first_name>
  <last_name>User</last_name>
  <links>
   <watched>
    <href>http://reviews.example.com/api/users/admin/watched/</href>
    <method>GET</method>
   </watched>
   <self>
    <href>http://reviews.example.com/api/users/admin/</href>
    <method>GET</method>
   </self>
  </links>
  <url>/users/admin/</url>
  <email>admin@example.com</email>
  <avatar_url>http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61</avatar_url>
  <fullname>Admin User</fullname>
  <id>1</id>
 </user>
</rsp>