---
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`

## Request

- Base URL: `https://agenticadvertising.org`
- URL: `https://agenticadvertising.org/api/registry/agents/{encodedUrl}/storyboard-status`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://agenticadvertising.org/authorize`
    - Token URL: `https://agenticadvertising.org/token`

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.
    - `skipped_steps` StoryboardSkippedStep[], required: Up to 5 cascaded prerequisite skips with runner reason/detail and the nearest earlier non-passing step, when captured. Owner-scoped; empty for other callers.
      - `step_id` string, nullable, required: Skipped step id (derived from the title when the runner omits it).
      - `title` string, nullable, required
      - `task` string, nullable, required
      - `reason` string, nullable, required: Runner skip reason, e.g. prerequisite_failed or controller_seeding_failed.
      - `detail` string, nullable, required: Redacted runner skip detail. May echo agent-supplied text.
      - `blocked_by_step_id` string, nullable, required: Nearest earlier step in the same storyboard that did not pass, when one exists.
      - `blocked_by_step_title` string, nullable, required
      - `blocked_by_reason` string, nullable, required: 'failed', or the skip reason of the earlier step.
    - `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

## Changes

- **2026-11-03** `d8f6af89f253`: 1 info
  - added the required property `storyboards/items/skipped_steps` to the response with the `200` status
- **2026-06-12** `7b7340dc4eb7`: 6 info
  - added the required property `storyboards/items/failure_count` to the response with the `200` status
  - added the required property `storyboards/items/first_failed_step_id` to the response with the `200` status
  - added the required property `storyboards/items/first_failed_step_task` to the response with the `200` status
  - added the required property `storyboards/items/first_failed_step_title` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/agents/:encodedUrl/storyboard-status/get.md)

---

[API](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) - [All operations](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/revisions/d8f6af89f253?raw)