Subscription Limits API

This API will return the current Weather API usage summary for your API key subscription. See Pricing for plan limits, and details.

Additionally the same information can be found in the following HTTP Response Headers returned with every weather data request:

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset

All parameters should be supplied to the Weather API as query string parameters.

Base URL

HTTP: http://api.weatherbit.io/v2.0/subscription/usage
HTTPS: https://api.weatherbit.io/v2.0/subscription/usage
Supported Methods: GET

Request Parameters

key=[key] (REQUIRED - Your Weatherbit API Key)

Example Request:

https://api.weatherbit.io/v2.0/subscription/usage?key=API_KEY

Example Response (JSON):


        {
          "calls_count":"20",
          "calls_remaining":55,
          "calls_reset_ts":1518208120,
          "historical_calls_count":"18",
          "historical_calls_remaining":232,
          "historical_calls_reset_ts":1518286465,
        }
        

Field Decriptions:

  • calls_count: Number of API calls made in the current rate period.
  • calls_remaining: Number of API calls remaining in the current rate period.
  • calls_reset_ts: (Unix timestamp) API rate period reset time.
  • historical_calls: Number of historical data calls made in the current rate period.
  • historical_calls_remaining: Number of remaining historical data calls in the current rate period.
  • historical_calls_reset_ts: (Unix timestamp) Historical API(s) rate period reset time.