GET application/rate_limit_status

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 API Rate Limiting and review the limits.

Resource URL

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

Resource Information

Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
180
Requests / 15-min window (app auth)
180

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 API Rate Limiting for more information.

Example Values: statuses,friends,trends,help

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET

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

Example Result

{
  "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
      }
    }
  }
}