This snapshot, taken on
27/09/2010
, shows web content acquired for preservation by The National Archives. External links, forms and search may not work in archived websites and contact details are likely to be out of date.
 
 
The UK Government Web Archive does not use cookies but some may be left in your browser from archived websites.

Basic Auth has been deprecated.

Attention! August 31, 2010 Basic Auth has been deprecated. All applications must now use OAuth. Read more »   x

Don't fret! @twitterapi is here to help! Feel free to reach out to us directly, or via our Twitter Development Talk group.

The switch to OAuth is a good thing! You, as the application developer,

  • don't have the burden of keeping potentially damaging credentials for your users (especially considering that a lot of people use the same password for multiple services);
  • don't have to worry about the user changing their password — a user can change his or her password and the OAuth "connection" to your app will still work;
  • don't have to worry about other applications masquerading as your application as only your application can set the byline with your application name;
  • will eventually have access to more trusted APIs from Twitter that will only be available to "trusted" OAuth-enabled applications; and
  • will be contributing to the web of trust between users, service providers, and applications.

Choose your authorization path.

GET account/rate_limit_status

Home › Documentation › Account Resources › account/rate_limit_status

Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour. Calls to rate_limit_status do not count against the rate limit. If authentication credentials are provided, the rate limit status for the authenticating user is returned. Otherwise, the rate limit status for the requester's IP address is returned. Learn more about the REST API rate limiting.

URL

http://api.twitter.com/version/account/rate_limit_status.format

Supported formats

json, xml

Supported request methods

GET

Requires Authentication

false About authentication »

This will return the requesting IP's rate limit status. If you want the authenticating user's rate limit status you must authenticate.

Rate Limited

false About rate limiting »

Example requests

JSON

Try it! » twurl /1/account/rate_limit_status.json 
1
2
3
4
5
6

{
  "remaining_hits": 150,
  "reset_time_in_seconds": 1277234708,
  "hourly_limit": 150,
  "reset_time": "Tue Jun 22 19:25:08 +0000 2010"
}

XML

Try it! » twurl /1/account/rate_limit_status.json 
1
2
3
4
5
6
7

<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <hourly-limit type="integer">150</hourly-limit>
  <reset-time-in-seconds type="integer">1277234732</reset-time-in-seconds>
  <reset-time type="datetime">2010-06-22T19:25:32+00:00</reset-time>
  <remaining-hits type="integer">150</remaining-hits>
</hash>
This document last updated by themattharris on June 17, 2010