Get Data Freshness
curl --request GET \
--url https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness \
--header 'X-API-KEY: <api-key>'import requests
url = "https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data_as_of": "2026-10-15T12:00:00+00:00",
"lag_seconds": 12.3,
"version": 1792584000000000
}{
"message": "Failed to fetch data freshness!"
}Get Data Freshness
Get how up to date your workspace’s analytics data is, as a data-as-of timestamp and lag in seconds, to label dashboards and decide when to refetch.
GET
/
analytics
/
v4
/
data-freshness
Get Data Freshness
curl --request GET \
--url https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness \
--header 'X-API-KEY: <api-key>'import requests
url = "https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://prod-api.ringg.ai/ca/api/v0/analytics/v4/data-freshness', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data_as_of": "2026-10-15T12:00:00+00:00",
"lag_seconds": 12.3,
"version": 1792584000000000
}{
"message": "Failed to fetch data freshness!"
}Show
data_as_of as a “data as of” label. version changes whenever new data lands, so refetch only when it differs from the last value you saw.
Notes
data_as_ofandlag_secondsarenullandversionis0before your workspace has any analytics data.
Errors
401:X-API-KEYis missing or invalid.
Authorizations
Response
Data freshness retrieved successfully.
Was this page helpful?