---
title: "List my registered agents"
method: GET
path: "/api/me/agents"
tags: ["Member Agents"]
---

# List my registered agents

`GET /api/me/agents`

List the agents registered on the caller's organization member profile. Returns the same `agents[]` array stored on the profile, in the order members registered them.

## Query parameters

- `org` string — WorkOS organization id to act on. Defaults to the caller's primary organization. Use this from a multi-org session (or when shelling with a user JWT) to target a non-primary org. Verification goes through WorkOS membership lookup; non-members get `403`.

## Response `200`

Registered agents

- MemberAgentListResponse
  - `agents` MemberAgent[], required
    - `url` string, uri, required
    - `visibility` 'private' | 'members_only' | 'public', required — Visibility tier on the registry catalog. `private` = profile owner only; `members_only` = AAO API-tier members on operator lookup; `public` = listed in the public catalog and reflected in the org's `brand.json` (requires a paid AAO tier — Professional, Builder, Member, or Leader).
    - `type` 'brand' | 'rights' | 'measurement' | 'governance' | 'creative' | 'sales' | 'buying' | 'signals' | 'unknown', required — Agent type as stored on the registry. Server-side smuggle protection compares the caller's declaration against the capability snapshot (when one exists) and may stamp `unknown` if the snapshot contradicts the declaration without classifying it. `unknown` is reserved for that server-side outcome; clients cannot submit it.
    - `name` string
    - `health_check_url` string, uri — Optional fallback liveness URL used by the health probe when the protocol handshake fails.

## Other responses

- `400` — No organization associated with this account
- `401` — Authentication required
- `403` — `?org=` was supplied but the caller is not a member of that organization.
- `404` — No member profile exists yet — create one via `POST /api/me/member-profile`.

---

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