---
title: "Operator lookup"
method: GET
path: "/api/registry/operator"
tags: ["Authorization Lookups"]
---

# Operator lookup

`GET /api/registry/operator`

Given a domain, returns the agents this entity operates and which publishers trust them.

**Response shape is auth-aware.** Anonymous callers see only `public` agents. Authenticated callers on an AAO membership tier with API access also see `members_only` agents. Profile owners (callers whose org owns the queried domain) additionally see `private` agents. This is the primary mechanism by which AAO membership unlocks deeper registry visibility.

**`scope` bucket filter.** Callers can opt INTO a single visibility bucket (or the full union) regardless of what their auth would otherwise unlock — useful for picker UIs that want exactly one slice (e.g. anonymous-equivalent, members-only catalog, owner's private drafts). `scope` only narrows; it never escalates (e.g. `scope=member` on an explorer or anonymous caller silently returns public only).

**Member level visibility.** When the profile owner has set their member card to public (`is_public=true`), the `member` object additionally carries `is_founding_member` (boolean) plus `membership_tier` (raw enum) and `membership_tier_label` (e.g. `Professional`, `Partner`, `Leader`) when the org has a resolvable tier. Founding Member is orthogonal to tier — founding orgs typically display both. For private profiles these fields are absent.

## Query parameters

- `domain` string, required
- `scope` 'public' | 'member' | 'private' | 'all' — Visibility bucket filter for returned agents. One value per agent-visibility enum value plus a catch-all. Each bucket is still gated by auth — `scope` can only narrow, never escalate. - `public` → only `visibility=public` agents. - `member` → public + members_only (members_only is gated on caller's tier; anonymous or explorer-tier callers silently fall through to public-only rather than 403). - `private` → only `visibility=private`. Private agents are visible only to the profile owner; non-owners get an empty list. - Omitted or `all` → tier-aware full unlock: public + members_only for API-tier members + private for the profile owner. Unknown values return 400 — a silent coerce to `all` could leak data the caller explicitly tried to scope away from.

## Response `200`

Operator lookup result

- OperatorLookupResult
  - `domain` string, required
  - `member` object, nullable, required
    - `slug` string
    - `display_name` string
    - `membership_tier` string — Raw AAO membership tier enum (e.g. `individual_professional`, `company_leader`). Present only when the profile owner has set their member card to public (`is_public=true`) AND the org has a resolvable tier. Absent for private profiles and for orgs without an active tier-bearing subscription.
    - `membership_tier_label` string — Human-readable label for `membership_tier` (e.g. `Professional`, `Partner`, `Leader`). Matches the AAO pricing page. Use this for UI display; the raw enum is for programmatic gating. Presence rules match `membership_tier`.
    - `is_founding_member` boolean — True when the profile owner carries the Founding Member badge (joined before the founding-cohort cutoff). Surfaced when the profile owner has set their member card to public (`is_public=true`). Absent for private profiles. Founding Member is orthogonal to tier — founding orgs typically display both (e.g. Scope3 shows `Partner` + `Founding Member`).
  - `agents` object[], required
    - `url` string, required
    - `name` string, required
    - `type` 'brand' | 'rights' | 'measurement' | 'governance' | 'creative' | 'sales' | 'buying' | 'signals' | 'unknown', required
    - `authorized_by` object[], required
      - `publisher_domain` string, required
      - `authorized_for` string
      - `source` 'adagents_json' | 'agent_claim', required

## Other responses

- `400` — Missing or invalid domain, or unknown scope value

---

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