Set your default language: PHP | Curl

GET users/:id/pings

Get a list of Pings for 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 Pings for. Include this ID in the URL of the request.
key The application ID for the application making the request.
min_id Limit the result to no pings lower than this ID. This is useful for 'pull to refresh' functionality.

For example, you would take the last ping ID that the user has seen and set that as the min_id- No pings with an id lower than that will be returned in the timeline response.
max_id Limit the result to no pings higher than this ID. This is useful for paging to the next page of pings.

For example, if you pull a timeline page of 20 pings, and the last ID on the first page is 7838483, to get the next page, you would set that as the max_id, and all of the pings returned will have an ID less than 7838483.

The result is non-inclusive, and WILL NOT contain the ping data for 7838483.
count The number is pings you want returned. You can set this up to 200 max, after which we will limit the result to the last 200 pings.
username Force the :id parameter to refer to a username instead of a user ID. Possible values are 1 or 0.


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);

  // Get an array of Heello Pings for user 'heello'
  $pings = $api->users->pings(array(
    "id" => "heello",
    "username" => 1,
    "count" => 10

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