v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB
Authorization Lookups

AAO directory inverse-lookup

Given a percent-encoded agent_url, returns the publishers whose adagents.json authorizes that agent, with provenance (discovery_method, manager_domain), per-publisher property counts (properties_authorized, properties_total, scoped to this publisher only — never network-wide), signing-key pin status, and lifecycle state (authorized / revoked).

Spec: docs/aao/directory-api.mdx (adcp#4823). This endpoint is the spec-compliant richer-shape replacement for the legacy /api/registry/lookup/agent/{agentUrl}/domains, which returns domain strings only.

get/api/v1/agents/{encodedUrl}/publishers

Path parameters

encodedUrlstring required

Percent-encoded agent_url

Percent-encoded agent_url

Query parameters

sincestring date-time

ISO 8601 — return only publishers with last_verified_at ≥ since

ISO 8601 — return only publishers with last_verified_at ≥ since

cursorstring

Opaque pagination cursor returned by a prior response

Opaque pagination cursor returned by a prior response

statusstring[]

Lifecycle status filter — repeat the key once per value (?status=authorized&status=revoked). Default: authorized. The comma-separated single-value form is rejected with 400.

Lifecycle status filter — repeat the key once per value (?status=authorized&status=revoked). Default: authorized. The comma-separated single-value form is rejected with 400.

includestring[]

Opt into expanded per-row fields — repeat the key once per value. v1: properties adds property_ids[] to each PublisherEntry so consumers can run full set-diff against a federated fetch (count-equality is not set-equality). Unknown values return 400. The comma-separated form is rejected with 400.

Opt into expanded per-row fields — repeat the key once per value. v1: properties adds property_ids[] to each PublisherEntry so consumers can run full set-diff against a federated fetch (count-equality is not set-equality). Unknown values return 400. The comma-separated form is rejected with 400.

limitinteger

Page size, default 200, max 1000

Page size, default 200, max 1000

Response

Publishers authorizing the agent

agent_urlstring required
directory_indexed_atstring date-time nullable required

Most recent per-publisher refresh in this page. Null on empty pages (no anchor).

next_cursorstring nullable required