@adcp/sdk API Reference - v14.0.0-beta.6
    Preparing search index...

    Interface LegacyListCreativeFormatsRequest

    DEPRECATED in 3.2. Compatibility request for legacy named-format discovery. Sales agents expose purchasable canonical declarations on get_products Product.format_options[]; publisher acceptance comes from adagents.json formats[]; creative agents advertise build/validation/preview capabilities on get_adcp_capabilities creative.supported_formats[].

    interface LegacyListCreativeFormatsRequest {
        adcp_version?: string;
        adcp_major_version?: number;
        format_ids?: LegacyFormatReferenceStructuredObject[];
        asset_types?: AssetContentType[];
        max_width?: number;
        max_height?: number;
        min_width?: number;
        min_height?: number;
        is_responsive?: boolean;
        name_search?: string;
        publisher_domain?: string;
        property_id?: string;
        wcag_level?: WCAGLevel;
        disclosure_positions?: DisclosurePosition[];
        disclosure_persistence?: DisclosurePersistence[];
        output_format_ids?: LegacyFormatReferenceStructuredObject[];
        input_format_ids?: LegacyFormatReferenceStructuredObject[];
        pagination?: PaginationRequest;
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    adcp_version?: string

    Release-precision AdCP version (VERSION.RELEASE, e.g. "3.0", "3.1", "3.1-beta"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = "3.1.0-beta.1") MUST normalize to release-precision ("3.1-beta.1") before emitting on the wire — meta-field values are NOT valid wire values.

    adcp_major_version?: number

    DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.

    Deprecated in AdCP 3.2; removed in AdCP 4.0. Return only these specific named-format IDs (for example, from a 3.x get_products response). Use canonical-format discovery in 4.0.

    asset_types?: AssetContentType[]

    Filter to formats that include these asset types. For third-party tags, search for 'html' or 'javascript'. For published-post reference formats, search for 'published_post'. E.g., ['image', 'text'] returns formats with images and text, ['javascript'] returns formats accepting JavaScript tags.

    max_width?: number

    Maximum width in pixels (inclusive). Returns formats where ANY render has width <= this value. For multi-render formats, matches if at least one render fits.

    max_height?: number

    Maximum height in pixels (inclusive). Returns formats where ANY render has height <= this value. For multi-render formats, matches if at least one render fits.

    min_width?: number

    Minimum width in pixels (inclusive). Returns formats where ANY render has width >= this value.

    min_height?: number

    Minimum height in pixels (inclusive). Returns formats where ANY render has height >= this value.

    is_responsive?: boolean

    Filter for responsive formats that adapt to container size. When true, returns formats without fixed dimensions.

    name_search?: string

    Search for formats by name (case-insensitive partial match)

    publisher_domain?: string

    Deprecated compatibility filter for older 3.x callers. A compatibility implementation MAY project publisher-origin or community-catalog declarations obtained through the registry publisher lookup, but MUST NOT synthesize a publisher catalog from seller products. New callers use GET /api/registry/publisher?domain=... for publisher acceptance and get_products for this seller's deliverability. The pattern below is a syntactic floor, not an SSRF guard.

    ^a-z0-9?(.a-z0-9?)*$

    property_id?: string
    wcag_level?: WCAGLevel
    disclosure_positions?: DisclosurePosition[]

    Filter to formats that support all of these disclosure positions. When a format has disclosure_capabilities, match against those positions. Otherwise fall back to supported_disclosure_positions. Use to find formats compatible with a brief's compliance requirements.

    disclosure_persistence?: DisclosurePersistence[]

    Filter to formats where each requested persistence mode is supported by at least one position in disclosure_capabilities. Different positions may satisfy different modes. Use to find formats compatible with jurisdiction-specific persistence requirements (e.g., continuous for EU AI Act).

    Filter to formats whose output_format_ids includes any of these format IDs. Returns formats that can produce these outputs — inspect each result's input_format_ids to see what inputs they accept.

    Filter to formats whose input_format_ids includes any of these format IDs. Returns formats that accept these creatives as input — inspect each result's output_format_ids to see what they can produce.

    pagination?: PaginationRequest
    context?: ContextObject