Skip to main content
GET
List agents

Query Parameters

type
enum<string>
Available options:
brand,
rights,
measurement,
governance,
creative,
sales,
buying,
signals,
unknown
health
enum<string>
Available options:
true
capabilities
enum<string>
Available options:
true
properties
enum<string>
Available options:
true
compliance
enum<string>
Available options:
true
metric_id

Measurement-vendor filter: exact match on measurement.metrics[].metric_id. Repeatable; multiple values are AND'd (vendor must carry all named metrics). When combined with accreditation, a cross-product AND applies — each (metric_id, accreditation) pair must be covered by the same metrics element. Duplicate values are ignored. Maximum 20 unique values; maximum 100 cross-product pairs. Implies type=measurement.

Example:

"attention_units"

accreditation

Measurement-vendor filter: exact match on measurement.metrics[].accreditations[].accrediting_body (e.g. MRC, JIC, ARF). Repeatable; multiple values are AND'd. When combined with metric_id, a cross-product AND applies — see metric_id description. Duplicate values are ignored. Maximum 20 unique values; maximum 100 cross-product pairs. Implies type=measurement. Accreditation claims are vendor-asserted; AAO does not independently verify (verified_by_aao is always false in the response).

Example:

"MRC"

q
string

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.

Maximum string length: 64
Example:

"attention"

format_kind

Canonical creative-capability filter: exact match on creative.supported_formats[].format.format_kind. Repeatable with OR semantics. Matches standalone creative agents and mixed-role endpoints.

Example:

"video_hosted"

publisher_domain
string

Canonical creative-capability filter: exact publisher_domain on the same supported-format entry. Pair with format_option_id to find endpoints claiming an exact publisher format.

Example:

"shorts.streamhaus.example"

format_option_id
string

Canonical creative-capability filter: exact publisher format_option_id on the same supported-format entry.

Example:

"spotlight_video"

capability_id
string

Canonical creative-capability filter: exact endpoint-local creative.supported_formats[].capability_id.

creative_operation

Canonical creative-capability filter: required supported operation on the same format entry. Repeatable with OR semantics.

Available options:
build,
validate,
preview
Example:

"build"

verification_mode
enum<string>[]

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.

Available options:
spec,
live
verified
enum<string>

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

Available options:
true

Response

Agent list

agents
object[]
required
count
integer
required