GET application/rate_limit_status

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

Each API resource belongs to a “resource family” which is indicated in its method documentation. The method’s resource family can be determined 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 their 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, you should explicitly provide a resources parameter with the specified resource families you work with.

When using application-only auth, this method’s response indicates the application-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

Name Required Description Default Value Example
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.   statuses,friends,trends,help

Example Request

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

Example Response

{
  "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": 900,
        "remaining": 900,
        "reset": 1403602426
      },
      "/users/search": {
        "limit": 900,
        "remaining": 900,
        "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": 75,
        "remaining": 75,
        "reset": 1403602426
      },
      "/statuses/lookup": {
        "limit": 900,
        "remaining": 900,
        "reset": 1403602426
      },
      "/statuses/show/:id": {
        "limit": 900,
        "remaining": 900,
        "reset": 1403602426
      },
      "/statuses/oembed": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/statuses/retweeters/ids": {
        "limit": 75,
        "remaining": 75,
        "reset": 1403602426
      },
      "/statuses/home_timeline": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/statuses/user_timeline": {
        "limit": 900,
        "remaining": 900,
        "reset": 1403602426
      },
      "/statuses/retweets/:id": {
        "limit": 75,
        "remaining": 75,
        "reset": 1403602426
      },
      "/statuses/retweets_of_me": {
        "limit": 75,
        "remaining": 75,
        "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
      }
    }
  }
}