Jump to >

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
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.

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”.

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>