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 |
|
| 403 | Unauthorized/No Access for current plan level |
|
| 429 | Daily or Velocity limit exceeded See rate limit guidance. |
|
| 500 | Internal 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.