---
title: "Get community mirror"
method: GET
path: "/api/registry/mirrors/{platform}"
tags: ["Community Mirrors"]
---

# Get community mirror

`GET /api/registry/mirrors/{platform}`

Fetch one persisted community mirror by platform. A present mirror returns the platform metadata plus the stored catalog-only `adagents_json` document; absent mirrors return 404.

## Path parameters

- `platform` string, required — Lowercase platform identifier.

## Response `200`

Community mirror

- CommunityMirrorGetResponse
  - `platform` string, required — Lowercase platform identifier, normalized by the service.
  - `catalog_etag` string, nullable, required
  - `superseded_by` string, nullable, required — HTTPS successor document URL, when this mirror has been superseded.
  - `adagents_json` CommunityMirrorAdagentsJson, required
    - `$schema` string, uri
    - `authorized_agents` AdagentsAuthorizedAgent[], required — Always empty for community mirrors; these catalogs never assert sales authorization.
      - `url` string, uri, required — Agent endpoint URL.
      - `authorized_for` string
      - `authorization_type` 'property_ids' | 'property_tags' | 'inline_properties' | 'publisher_properties' | 'signal_ids' | 'signal_tags'
      - `property_ids` string[]
      - `property_tags` string[]
      - `properties` object[]
      - `publisher_properties` object[]
        - `publisher_domain` string
        - `publisher_domains` string[]
        - `selection_type` 'all' | 'by_id' | 'by_tag', required
        - `property_ids` string[]
        - `property_tags` string[]
      - `collections` object[]
        - `publisher_domain` string, required
        - `collection_ids` string[], required
      - `placement_ids` string[]
      - `placement_tags` string[]
      - `delegation_type` 'direct' | 'delegated' | 'ad_network'
      - `exclusive` boolean
      - `countries` string[]
      - `effective_from` string
      - `effective_until` string
      - `signal_ids` string[]
      - `signal_tags` string[]
      - `signing_keys` object[]
    - `properties` object[]
    - `catalog_etag` string
    - `formats` object[]
    - `placements` object[]
    - `placement_tags` object
    - `collections` object[]
    - `signals` object[]
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Clients should re-fetch the successor and update cached mirror references before retiring use of this mirror.
    - `last_updated` string, date-time
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Invalid platform identifier
- `404` — Community mirror not found
- `429` — Rate limit exceeded
- `500` — Failed to read community mirror

---

[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)