> ## Documentation Index
> Fetch the complete documentation index at: https://agenticadvertisingorg-feature-feedback.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get agent AAO Verified status

> Returns AAO Verified badge status for a single agent. Public and cacheable. Includes role badges, verified storyboards, and a link to the agent's registry listing.



## OpenAPI

````yaml /static/openapi/registry.yaml get /api/registry/agents/{encodedUrl}/verification
openapi: 3.1.0
info:
  title: AgenticAdvertising.org Registry API
  description: >-
    REST API for the AgenticAdvertising.org registry. Resolve brands,

    discover properties, look up agents, and validate authorization in the

    AdCP ecosystem.


    Most endpoints are public and require no authentication. Endpoints marked

    with a lock icon accept either an organization API key or a user JWT

    obtained via the OAuth 2.1 flow — see
    [Authentication](https://agenticadvertising.org/docs/registry/index#authentication).


    **Base URL:** `https://agenticadvertising.org`
  version: 1.0.0
  contact:
    name: AgenticAdvertising.org
    url: https://agenticadvertising.org
servers:
  - url: https://agenticadvertising.org
    description: Production
security: []
tags:
  - name: Onboarding
    description: >-
      Explicitly bootstrap a third-party integration into the AAO registry. Most
      callers don't need this tag — `POST /api/me/agents` auto-creates the org
      (for fresh users) and the member profile (for first-time agent
      registration) without a separate round trip. Use `POST /api/organizations`
      only when you need to override the auto-derived org name / company_type /
      revenue_tier. Tier transitions happen via the billing flow only; the
      Stripe webhook is the sole writer of `organizations.membership_tier`.
  - name: Member Agents
    description: >-
      Register, list, update, and remove agents on the caller's organization
      member profile. Authenticated programmatic surface for CI / scripts that
      don't want to round-trip the full member profile.
  - name: Brand Resolution
    description: Resolve advertiser domains to canonical brand identities.
  - name: Property Resolution
    description: >-
      Resolve publisher domains to their property configurations and authorized
      agents.
  - name: Agent Discovery
    description: >-
      Browse the federated agent network, search agent inventory profiles,
      publisher index, and registry statistics.
  - name: Change Feed
    description: Poll cursor-based registry change events for local sync.
  - name: Lookups & Authorization
    description: >-
      Look up agents by domain or property, and validate ad-serving
      authorization.
  - name: Validation Tools
    description: >-
      Validate publisher adagents.json files and generate compliant
      configurations.
  - name: Community Mirrors
    description: >-
      Publish, fetch, list, and retire catalog-only adagents.json mirrors for
      platforms that have not adopted AdCP.
  - name: Search
    description: Cross-entity search across brands, publishers, agents, and properties.
  - name: Agent Probing
    description: >-
      Connect to live agents and inspect their capabilities, formats, and
      inventory.
  - name: Brand Discovery
    description: Discover and crawl brand.json files across domains.
  - name: Agent Compliance
    description: Agent compliance status, storyboard test results, and compliance history.
  - name: Policy Registry
    description: >-
      Browse, resolve, and contribute governance policies for campaign
      compliance.
paths:
  /api/registry/agents/{encodedUrl}/verification:
    get:
      tags:
        - Agent Compliance
      summary: Get agent AAO Verified status
      description: >-
        Returns AAO Verified badge status for a single agent. Public and
        cacheable. Includes role badges, verified storyboards, and a link to the
        agent's registry listing.
      operationId: getAgentVerification
      parameters:
        - schema:
            type: string
            description: URL-encoded agent URL
            example: https%3A%2F%2Fexample.com%2Fmcp
          required: true
          description: URL-encoded agent URL
          name: encodedUrl
          in: path
      responses:
        '200':
          description: Verification status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentVerification'
        '400':
          description: Invalid agent URL
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AgentVerification:
      type: object
      properties:
        agent_url:
          type: string
        verified:
          type: boolean
        badges:
          type: array
          items:
            $ref: '#/components/schemas/VerificationBadge'
        registry_url:
          type: string
      required:
        - agent_url
        - verified
        - badges
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    VerificationBadge:
      type: object
      properties:
        role:
          type: string
          enum:
            - media-buy
            - signals
            - governance
            - creative
            - brand
            - sponsored-intelligence
            - measurement
          description: AdCP protocol this badge covers (enums/adcp-protocol.json).
        adcp_version:
          type: string
          description: >-
            AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.0',
            '3.1'). Load-bearing for badge identity — pairs with the (agent_url,
            role, adcp_version) PK.
        verified_at:
          type: string
        verified_specialisms:
          type: array
          items:
            type: string
            enum:
              - audience-sync
              - brand-rights
              - collection-lists
              - content-standards
              - creative-ad-server
              - creative-generative
              - creative-template
              - creative-transformers
              - governance-aware-seller
              - governance-delivery-monitor
              - governance-spend-authority
              - property-lists
              - sales-broadcast-tv
              - sales-catalog-driven
              - sales-guaranteed
              - sales-non-guaranteed
              - sales-proposal-mode
              - sales-social
              - signal-marketplace
              - signal-owned
              - signed-requests
              - sponsored-intelligence
          description: >-
            Specialisms demonstrably passed (enums/specialism.json). Preview
            specialisms are excluded from stable badges.
        verification_modes:
          type: array
          items:
            type: string
            enum:
              - spec
              - live
          minItems: 1
          description: >-
            Verification axes earned. 'spec' = AdCP storyboards pass for the
            declared specialisms. 'live' = AAO has observed real production
            traffic via canonical campaigns. Always non-empty when a badge is
            present; an absent badge is conveyed by the parent record being
            omitted, not by an empty array.
        verified_protocol_version:
          type:
            - string
            - 'null'
        badge_url:
          type: string
          description: >-
            Legacy URL — auto-upgrades to the highest active version. For
            version-pinned embedding, derive
            `/api/registry/agents/{encoded_url}/badge/{role}/{adcp_version}.svg`
            where `{encoded_url}` is `encodeURIComponent(agent_url)`.
      required:
        - role
        - adcp_version
        - verified_at
        - verified_specialisms
        - verification_modes
        - verified_protocol_version

````