Sign in

v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB
Agent Discovery

List agents

List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (metric_id, accreditation, q) imply type=measurement when type is unset; an explicit type other than measurement returns 400.

get/api/registry/agents

Query parameters

type'brand' | 'rights' | 'measurement' | 'governance' | 'creative' | 'sales' | 'buying' | 'signals' | 'unknown'
health'true'
capabilities'true'
properties'true'
compliance'true'
string
OR
string[]

Measurement-vendor filter: exact match on measurement.metrics[].metric_id. Repeatable (each value is OR'd within the param, AND'd with other filters). Implies type=measurement.

string
OR
string[]

Measurement-vendor filter: exact match on measurement.metrics[].accreditations[].accrediting_body (e.g. MRC, JIC, ARF). Repeatable. Implies type=measurement. Accreditation claims are vendor-asserted; AAO does not independently verify (verified_by_aao is always false in the response).

qstring

Measurement-vendor filter: case-insensitive substring match against measurement.metrics[].metric_id. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies type=measurement.

Example:attention

Measurement-vendor filter: case-insensitive substring match against measurement.metrics[].metric_id. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies type=measurement.

verification_modestring[]

Filter to agents whose active badge covers the given verification axis. Repeat the parameter for AND semantics: ?verification_mode=spec&verification_mode=live returns only agents verified on both axes.

Filter to agents whose active badge covers the given verification axis. Repeat the parameter for AND semantics: ?verification_mode=spec&verification_mode=live returns only agents verified on both axes.

verified'true'

When true, filter to agents that hold any active verification badge.

When true, filter to agents that hold any active verification badge.

Response

Agent list

countinteger required

Example response

{
  "agents": [
    {
      "compliance": {
        "tracks": {
          "core": "pass",
          "products": "fail"
        }
      }
    }
  ]
}