<< Back to Twitter API Documentation

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/1/account/rate_limit_status.format

Formats: 

xml, json

HTTP Method(s):

GET

Requires Authentication (about authentication):

true, to determine a user's rate limit status

false, to determine the requesting IP's rate limit status

API rate limited (about rate limiting):

false

Response (about return values): 

          XML example:

<?xml version="1.0" encoding="UTF-8"?>

<hash>

<remaining-hits type="integer">19933</remaining-hits>

<hourly-limit type="integer">20000</hourly-limit>

<reset-time type="datetime">2009-04-08T21:57:23+00:00</reset-time>

<reset-time-in-seconds type="integer">1239227843</reset-time-in-seconds>

</hash>

Usage examples: 

cURL (about cURSaveL):

curl -u user:password http://api.twitter.com/1/account/rate_limit_status.xml

          Do you have an example to share in the language of your choice? Please share!

<< Back to Twitter API Documentation