Historical Data Revision Version API

Returns the current historical data revision version so you can detect finalized dataset updates.

API Guide

Historical Data Revision Version API

Returns the current historical data revision version so you can detect finalized dataset updates.

This API will return the current historical data revision version. This value is incremented whenever a change has been made to "final" data. The frequency of these changes are rare, but users can query this API to see if it may be necessary to retrieve updated historical data from the API.

Request Parameters

Field Optional/Required Type Data Type Description
key Required query string Your registered API key.

Example Request

Enter API key

Default

https://api.weatherbit.io/v2.0/history/revision_version?key=API_KEY
curl -s "https://api.weatherbit.io/v2.0/history/revision_version?key=API_KEY"
require 'uri'
require 'net/http'
require 'json'

uri = URI("https://api.weatherbit.io/v2.0/history/revision_version?key=API_KEY")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == "https")
request = Net::HTTP::Get.new(uri)
response = http.request(request)
json = JSON.parse(response.body)
puts JSON.pretty_generate(json)
const https = require("https");

https.get("https://api.weatherbit.io/v2.0/history/revision_version?key=API_KEY", (res) => {
  let raw = "";
  res.on("data", (chunk) => { raw += chunk; });
  res.on("end", () => {
    const json = JSON.parse(raw);
    console.log(JSON.stringify(json, null, 2));
  });
}).on("error", (err) => {
  console.error(err.message);
});
Estimated quota: 1 requeststandard

Example Response HTTP 200

{
  "revision_version": "2.1"
}

HTTP Statuses

Code Description Example
200 Historical revision version object. -
400 Client Error
{
  "error": "Some relevant message"
}
403 Unauthorized/No Access for current plan level
{
  "error": "Some relevant message"
}
429 Daily or Velocity limit exceeded See rate limit guidance.
{
  "error": "Rate limit exceeded.",
  "status_code": 429,
  "status_message": "Rate limit exceeded. Try again later."
}
500 Internal Server Error
{
  "error": "Server Error"
}

Return Fields

Field Data Type Description
revision_version string Current finalized historical data revision version.

Returns the current historical data revision version. Version changes indicate updates to final historical data revisions.