Get agent compliance detail

Returns detailed compliance status for a single agent, including track-level results, storyboard counts, and timestamps.

If the agent has opted out of compliance monitoring, returns a minimal response with status: opted_out.

GET /api/registry/agents/{encodedUrl}/compliance

Get agent compliance detail

cURL

curl --request GET \
  --url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/compliance

200

{
  "agent_url": "<string>",
  "compliance_opt_out": true,
  "tracks": {},
  "streak_days": 123,
  "last_checked_at": "<string>",
  "last_passed_at": "<string>",
  "last_failed_at": "<string>",
  "headline": "<string>",
  "status_changed_at": "<string>",
  "storyboards_passing": 123,
  "storyboards_total": 123,
  "check_interval_hours": 123,
  "declared_specialisms": [
    "<string>"
  ],
  "specialism_status": {},
  "membership_tier": "<string>",
  "membership_tier_label": "<string>",
  "subscription_status": "<string>",
  "is_api_access_tier": true,
  "verified": true,
  "verified_badges": [
    {
      "adcp_version": "<string>",
      "verified_at": "<string>",
      "verified_specialisms": [],
      "verification_modes": [],
      "verified_protocol_version": "<string>",
      "badge_url": "<string>"
    }
  ]
}

Path Parameters

encodedUrl · string · required

URL-encoded agent URL

Example:

"https%3A%2F%2Fexample.com%2Fmcp"

Response

200

application/json

Compliance detail

agent_url · string · required

status · enum<string> · required

Available options: passing, degraded, failing, unknown, opted_out

lifecycle_stage · enum<string> · required

Available options: development, testing, production, deprecated

compliance_opt_out · boolean

tracks · object

Show child attributes

streak_days · integer

last_checked_at · string | null

last_passed_at · string | null

last_failed_at · string | null

headline · string | null

status_changed_at · string | null

storyboards_passing · integer

storyboards_total · integer

check_interval_hours · integer

How often the heartbeat re-tests this agent, in hours

declared_specialisms · string[]

Specialisms the agent declared in get_adcp_capabilities, from the latest run

specialism_status · object

Per-specialism pass/fail/untested status — keyed on declared specialism, derived from the matching storyboard's status

Show child attributes

membership_tier · string | null

Owner-scoped: the agent owner's membership tier. Populated only when the authenticated viewer owns the agent; null otherwise. Field is always present so response shape doesn't reveal ownership.

membership_tier_label · string | null

Owner-scoped: human-readable label for membership_tier (e.g. 'Builder'). Null for non-owners.

subscription_status · string | null

Owner-scoped: the agent owner's subscription status (active, past_due, trialing, etc.). Null for non-owners.

is_api_access_tier · boolean

Owner-scoped: true when the owner's tier and subscription status grant badge eligibility. False for non-owners. Single source of truth — UI should not re-derive.

verdict_source · enum<string> | null

Owner-scoped: triggered_by value of the most recent non-dry-run compliance check. Null for non-owners and when no run has been recorded. Operators use this as a UX cue ('did this verdict come from my recent test or the system heartbeat?').

Available options: heartbeat, owner_test, manual, webhook, null

verified · boolean

verified_badges · object[]

Show child attributes