Get Asset

Retrieve details for a specific data asset

GET /api/v1/assets/{asset_id}

Get Asset

cURL

curl --request GET \
  --url https://api.anomalyarmor.ai/api/v1/assets/{asset_id}

200

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

Get complete details for a single asset including columns, relationships, freshness status, and tags.

When to Use

• Asset details: Get full metadata for a specific table
• Column inspection: List all columns with types and descriptions
• Freshness check: Verify data recency for a single asset
• Integration sync: Pull asset metadata into external tools

SDK & CLI Examples

Python SDK

from anomalyarmor import Client

client = Client(api_key="aa_live_xxx")

# Get by qualified name
asset = client.assets.get("snowflake.prod.public.orders")

print(f"Table: {asset.name}")
print(f"Columns: {len(asset.columns)}")
print(f"Freshness: {asset.freshness_status}")

# Access column details
for col in asset.columns:
    print(f"  {col.name}: {col.data_type}")

# Get by UUID
asset = client.assets.get(id="550e8400-e29b-41d4-a716-446655440000")

Parameters

Parameter	Type	Description
asset_id	string	Asset ID (UUID) or qualified name
include_columns	boolean	Include column details (default: true)

Response

{
  "id": "ast_abc123",
  "qualified_name": "snowflake.prod.public.orders",
  "asset_type": "table",
  "source": "snowflake.prod",
  "schema": "public",
  "name": "orders",
  "description": "Customer order records including order details and fulfillment status",
  "freshness": {
    "status": "fresh",
    "last_updated": "2024-01-15T08:30:00Z",
    "sla_threshold": "2h",
    "checked_at": "2024-01-15T09:00:00Z"
  },
  "columns": [
    {
      "name": "order_id",
      "data_type": "integer",
      "nullable": false,
      "description": "Unique identifier for each order",
      "tags": []
    },
    {
      "name": "user_email",
      "data_type": "varchar(255)",
      "nullable": true,
      "description": "Customer email address",
      "tags": ["pii:email"]
    }
  ],
  "tags": ["production", "critical"],
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-15T08:30:00Z"
}

Response Fields

Field	Description
id	Unique asset identifier
qualified_name	Full path: source.schema.table
description	Human-readable description (generated or manual)
freshness.status	fresh, stale, or unknown
freshness.last_updated	Timestamp of most recent data
freshness.sla_threshold	Configured freshness SLA
columns	Array of column definitions
columns[].tags	Classification tags on this column
tags	Asset-level tags

Error Responses

Status	Meaning
401	Invalid or missing API key
404	Asset not found
429	Rate limit exceeded

Path Parameters

asset_id · string<uuid> · required

Response

200

application/json

Successful Response

Standard API response format.

success · boolean · required

data · unknown

message · string | null

error · Error · object

meta · Meta · object