Get Freshness Status

Get Asset Freshness Overview

curl --request GET \
  --url http://localhost:8000/api/v1/assets/{asset_id}/freshness

const options = {method: 'GET'};

fetch('http://localhost:8000/api/v1/assets/{asset_id}/freshness', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": null,
  "message": "<string>",
  "error": "<string>",
  "meta": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

api

assets

{asset_id}

freshness

Get Asset Freshness Overview

curl --request GET \
  --url http://localhost:8000/api/v1/assets/{asset_id}/freshness

const options = {method: 'GET'};

fetch('http://localhost:8000/api/v1/assets/{asset_id}/freshness', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": null,
  "message": "<string>",
  "error": "<string>",
  "meta": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Check whether data is fresh or stale. Use this to gate pipelines, build monitoring dashboards, or verify SLA compliance.

When to Use

Pipeline gating: Fail jobs if upstream data is stale
Dashboards: Show freshness status in monitoring tools
SLA tracking: Verify data meets freshness requirements
Alerting integration: Build custom alert workflows

SDK & CLI Examples

from anomalyarmor import Client
from anomalyarmor.exceptions import StalenessError

client = Client(api_key="aa_live_xxx")

# Check freshness for a single asset
freshness = client.freshness.get("snowflake.prod.public.orders")
print(f"Status: {freshness.status}")
print(f"Last updated: {freshness.last_updated}")
print(f"SLA threshold: {freshness.sla_threshold}")

# Require fresh data (raises StalenessError if stale)
try:
    client.freshness.require_fresh("snowflake.prod.public.orders")
    print("Data is fresh, safe to proceed")
except StalenessError as e:
    print(f"Data is stale! Last update: {e.last_updated}")

# Check freshness
anomalyarmor freshness check snowflake.prod.public.orders

# Output as JSON
anomalyarmor freshness check snowflake.prod.public.orders --format json

Parameters

Parameter	Type	Description
`asset_id`	string	Asset ID or qualified name

Response

{
  "asset": "snowflake.prod.public.orders",
  "status": "fresh",
  "last_updated": "2024-01-15T08:30:00Z",
  "sla_threshold": "2h",
  "sla_status": "within_sla",
  "checked_at": "2024-01-15T09:00:00Z",
  "timestamp_column": "created_at",
  "data_age_minutes": 30
}

Response Fields

Field	Description
`status`	`fresh`, `stale`, or `unknown`
`last_updated`	Timestamp of most recent data in the table
`sla_threshold`	Configured freshness SLA (e.g., “2h”, “24h”)
`sla_status`	`within_sla`, `warning`, or `violated`
`checked_at`	When this freshness check ran
`timestamp_column`	Column used to determine freshness
`data_age_minutes`	How old the data is in minutes

Status Values

Status	Meaning
`fresh`	Data updated within SLA threshold
`stale`	Data older than SLA threshold
`unknown`	No timestamp column configured or no data

Error Responses

Status	Meaning
`401`	Invalid or missing API key
`404`	Asset not found
`422`	No freshness configuration for this asset
`429`	Rate limit exceeded

Headers

Authorization

string

Path Parameters

asset_id

string<uuid>

required

Query Parameters

limit

integer

default:20

Maximum tables to return

Required range: 1 <= x <= 100

offset

integer

default:0

Number of tables to skip

Required range: x >= 0

status_filters

string | null

Comma-separated status filters (ready,not_ready,unknown,error)

schema_filters

string | null

Comma-separated schema filters

tag_filters

string | null

Comma-separated tag filters

search_query

string | null

Search query for table names

Response

Successful Response

Standard API response wrapper.

success

boolean

required

data

unknown

message

string | null

error

string | null

API Overview

API Reference

API Guides

SDKs

CLI

Integrations

AI Agents

When to Use

SDK & CLI Examples

Parameters

Response

Response Fields

Status Values

Error Responses

Headers

Path Parameters

Query Parameters

Response

​When to Use

​SDK & CLI Examples

​Parameters

​Response

​Response Fields

​Status Values

​Error Responses

Headers

Path Parameters

Query Parameters

Response

When to Use

SDK & CLI Examples

Parameters

Response

Response Fields

Status Values

Error Responses