---
title: "Get agent storyboard status"
method: GET
path: "/api/registry/agents/{encodedUrl}/storyboard-status"
tags: ["Agent Compliance"]
---

# Get agent storyboard status

`GET /api/registry/agents/{encodedUrl}/storyboard-status`

Returns per-storyboard test results for an agent. Includes title, category, track, pass/fail status, and step counts.

**Members only** — requires authentication and an active membership. Static admin API key callers may read this for support/debugging.

## Path parameters

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

## Response `200`

Storyboard status for the agent

- object
  - `agent_url` string, required
  - `storyboards` StoryboardStatus[], required
    - `storyboard_id` string, required
    - `requested_compliance_target` string, nullable — Requested compliance target from the run that produced this storyboard verdict, e.g. 3.0 or 3.1-beta.
    - `adcp_version` string, nullable — Concrete AdCP compliance bundle version from the run that produced this storyboard verdict.
    - `title` string, required
    - `category` string, nullable, required
    - `track` string, nullable, required
    - `status` 'passing' | 'failing' | 'partial' | 'untested', required
    - `steps_passed` integer, required
    - `steps_total` integer, required
    - `failure_count` integer, required — Root failing or actionable skipped step count. Cascaded prerequisite skips are excluded.
    - `skipped_count` integer, required — Cascaded prerequisite skip count for this storyboard verdict.
    - `first_failed_step_id` string, nullable, required — First root failing or actionable skipped step id, when captured.
    - `first_failed_step_title` string, nullable, required — First root failing or actionable skipped step title, when captured.
    - `first_failed_step_task` string, nullable, required — Task/tool name for the first root failing or actionable skipped step, when captured.
    - `first_failure_message` string, nullable, required — Runner error/detail text for the first root failing or actionable skipped step, when captured.
    - `last_tested_at` string, nullable, required
    - `last_passed_at` string, nullable, required
  - `passing_count` integer, required
  - `total_count` integer, required

## Other responses

- `400` — Invalid agent URL
- `401` — Authentication required
- `403` — Members only
- `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/revisions/9ea7fedf54c0/schema)