Jump to >

User Resource

Name user
URI /api/users/{username}/

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


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.


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



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


<?xml version="1.0" encoding="utf-8"?>
  <fullname>Admin User</fullname>