Set your default language: PHP | Curl

GET users/:id

Used for retrieving information about a given user.


Requires Authentication No
Rate Limited Yes
Response Formats json


Parameter Required Notes
:id The user ID or username of the user to retrieve. Include this ID in the URL of the request.
key The application ID for the application making the request.
username Force the :id parameter to refer to a username instead of a user ID.

Possible values are 1 or 0
access_token If included, the response will show listen(s) relationships of the user being searched to the user designated with the access token.


There are no unique error states for this endpoint, please see our page detailing general errors you may encounter.

Example Usage

// Note: PHP Examples use the Heello PHP Client library
require_once dirname(dirname(dirname(__FILE__))) . '/Heello.php';

// You can get an Application Key and Secret by visiting:
$api_application_key = "APPLICATION_KEY";
$api_application_secret = "APPLICATION_SECRET";

$api = new Heello\Client($api_application_key, $api_application_secret);

  // Show the user basic information
  $user = $api->users->show(array(
    "id" => 2,

  $id = $user->id;
  $name = $user->name;
} catch (Exception $e){
  print $e->getMessage();
Please use the "Live Demo" below to see an example response.
You may need to login or create an account before making requests against the API.

Live Demo

Please login and create an application to perform live API testing.