---
title: "Get per-step diagnostics for a compliance run"
method: GET
path: "/api/registry/agents/{encodedUrl}/compliance/diagnostics"
tags: ["Agent Compliance"]
---

# Get per-step diagnostics for a compliance run

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

Returns the exact request and response payloads the runner captured for failing storyboard steps on a single compliance run.

Lets agent owners diff what the runner sent against their own probes without re-running the storyboard. Owner-only, with static admin API key access for support/debugging — payloads echo seller-side account/brand identifiers and may carry sensitive descriptive fields. If `run_id` is omitted, resolves to the latest run for the agent.

## Path parameters

- `encodedUrl` string, required — URL-encoded agent URL

## Query parameters

- `run_id` string — Specific compliance run UUID. Defaults to latest.
- `limit` string — Max rows (default 500, max 1000)

## Response `200`

Per-step diagnostics for the requested run

- object
  - `agent_url` string, required
  - `run_id` string, nullable, required
  - `count` integer, required
  - `diagnostics` ComplianceStepDiagnostic[], required
    - `id` union, required
      - number
      - string
    - `run_id` string, required
    - `agent_url` string, required
    - `storyboard_id` string, required
    - `phase_id` string, required
    - `step_id` string, required
    - `task` string, required
    - `step_passed` boolean, required
    - `duration_ms` number, nullable
    - `request_url` string, nullable
    - `request_jsonb` unknown
    - `response_status` number, nullable
    - `response_headers_jsonb` object, nullable
    - `response_jsonb` unknown
    - `extraction_path` string, nullable
    - `extraction_note` string, nullable
    - `error_text` string, nullable
    - `adcp_error_jsonb` unknown
    - `failed_validations_jsonb` unknown
    - `served_by_agent_url` string, nullable
    - `captured_at` string, required

## Other responses

- `400` — Invalid agent URL
- `401` — Authentication required
- `403` — Not authorized
- `500` — Server error

---

[API](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) · [All operations](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcontextprotocol/agenticadvertising-org-registry-api/versions/9ea7fedf54c0/schema)