GET application/rate_limit_status

Updated on Tue, 2014-06-24 02:19

Returns the current rate limits for methods belonging to the specified resource families.

Each 1.1 API resource belongs to a "resource family" which is indicated in its method documentation. You can typically determine a method's resource family from the first component of the path after the resource version.

This method responds with a map of methods belonging to the families specified by the resources parameter, the current remaining uses for each of those resources within the current rate limiting window, and its expiration time in epoch time. It also includes a rate_limit_context field that indicates the current access token or application-only authentication context.

You may also issue requests to this method without any parameters to receive a map of all rate limited GET methods. If your application only uses a few of methods, please explicitly provide a resources parameter with the specified resource families you work with.

When using app-only auth, this method's response indicates the app-only auth rate limiting context.

Read more about REST API Rate Limiting in v1.1 and review the limits.

Resource URL

https://api.twitter.com/1.1/application/rate_limit_status.json

Parameters

resources optional

A comma-separated list of resource families you want to know the current rate limit disposition for. For best performance, only specify the resource families pertinent to your application.

See Rate Limiting in API v1.1 for more information.

Example Values: statuses,friends,trends,help

Example Request

GET	`https://api.twitter.com/1.1/application/rate_limit_status.json?resources=help,users,search,statuses`

```
{
```
```
  "rate_limit_context": {
```

    "access_token": "786491-24zE39NUezJ8UTmOGOtLhgyLgCkPyY4dAcx6NA6sDKw"

```
  },
```
```
  "resources": {
```
```
    "users": {
```
```
      "/users/profile_banner": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```

      "/users/suggestions/:slug/members": {

```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/show/:id": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/suggestions": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/lookup": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/search": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/contributors": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/contributees": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/users/suggestions/:slug": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      }
```
```
    },
```
```
    "statuses": {
```
```
      "/statuses/mentions_timeline": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/lookup": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/show/:id": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/oembed": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/retweeters/ids": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/home_timeline": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/user_timeline": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/retweets/:id": {
```
```
        "limit": 60,
```
```
        "remaining": 60,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/statuses/retweets_of_me": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      }
```
```
    },
```
```
    "help": {
```
```
      "/help/privacy": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/help/tos": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/help/configuration": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      },
```
```
      "/help/languages": {
```
```
        "limit": 15,
```
```
        "remaining": 15,
```
```
        "reset": 1403602426
```
```
      }
```
```
    },
```
```
    "search": {
```
```
      "/search/tweets": {
```
```
        "limit": 180,
```
```
        "remaining": 180,
```
```
        "reset": 1403602426
```
```
      }
```
```
    }
```
```
  }
```
```
}
```

Resource Information

Rate Limited?	Yes
Requests per rate limit window	180/user 180/app
Authentication	Required
Response Formats	json
HTTP Methods	GET
Resource family	application
API Version	v1.1

OAuth tool

Please Sign in with your Twitter account in order to use the OAuth tool.