Function listPropertyListsResponse

Parameters

• data: {
      context?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
      governance_context?: string;
      lists: {
          list_id: string;
          name: string;
          description?: string;
          account?: | { account_id: string }
          | {
              brand: {
                  domain: string;
                  brand_id?: string;
                  industries?: string[];
                  data_subject_contestation?: {
                      url?: string;
                      email?: string;
                      languages?: string[];
                  };
                  brand_kit_override?: {
                      logo?: {
                          asset_type: "image";
                          url: string;
                          width: number;
                          height: number;
                          format?: (...)
                          | (...);
                          alt_text?: (...) | (...);
                          provenance?: (...) | (...);
                      };
                      colors?: {
                          primary?: (...)
                          | (...);
                          secondary?: (...) | (...);
                          accent?: (...) | (...);
                      };
                      voice?: string;
                      tagline?: string;
                  };
              };
              operator: string;
              sandbox?: boolean;
          };
          base_properties?: (
              | {
                  selection_type: "publisher_tags";
                  publisher_domain: string;
                  tags: string[];
              }
              | {
                  selection_type: "publisher_ids";
                  publisher_domain: string;
                  property_ids: string[];
              }
              | {
                  selection_type: "identifiers";
                  identifiers: { type: PropertyIdentifierTypes; value: string }[];
              }
          )[];
          filters?: {
              countries_all?: string[];
              channels_any?: MediaChannel[];
              property_types?: PropertyType[];
              feature_requirements?: {
                  feature_id: string;
                  min_value?: number;
                  max_value?: number;
                  allowed_values?: unknown[];
                  if_not_covered?: "include"
                  | "exclude";
                  policy_id?: string;
              }[];
              exclude_identifiers?: { type: PropertyIdentifierTypes; value: string }[];
          };
          brand?: {
              domain: string;
              brand_id?: string;
              industries?: string[];
              data_subject_contestation?: {
                  url?: string;
                  email?: string;
                  languages?: string[];
              };
              brand_kit_override?: {
                  logo?: {
                      asset_type: "image";
                      url: string;
                      width: number;
                      height: number;
                      format?: string;
                      alt_text?: string;
                      provenance?: {
                          digital_source_type?: ...;
                          ai_tool?: ...;
                          human_oversight?: ...;
                          declared_by?: ...;
                          declared_at?: ...;
                          created_time?: ...;
                          c2pa?: ...;
                          embedded_provenance?: ...;
                          watermarks?: ...;
                          disclosure?: ...;
                          verification?: ...;
                          ext?: ...;
                      };
                  };
                  colors?: { primary?: string; secondary?: string; accent?: string };
                  voice?: string;
                  tagline?: string;
              };
          };
          webhook_url?: string;
          cache_duration_hours?: number;
          created_at?: string;
          updated_at?: string;
          property_count?: number;
          pricing_options?: (
              | {
                  pricing_option_id: string;
                  applies_to_output_format_ids?: {
                      agent_url: string;
                      id: string;
                      width?: (...)
                      | (...);
                      height?: (...) | (...);
                      duration_ms?: (...) | (...);
                  }[];
                  model: "cpm";
                  cpm: number;
                  currency: string;
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
              | {
                  pricing_option_id: string;
                  applies_to_output_format_ids?: {
                      agent_url: string;
                      id: string;
                      width?: (...)
                      | (...);
                      height?: (...) | (...);
                      duration_ms?: (...) | (...);
                  }[];
                  model: "percent_of_media";
                  percent: number;
                  max_cpm?: number;
                  currency: string;
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
              | {
                  pricing_option_id: string;
                  applies_to_output_format_ids?: {
                      agent_url: string;
                      id: string;
                      width?: (...)
                      | (...);
                      height?: (...) | (...);
                      duration_ms?: (...) | (...);
                  }[];
                  model: "flat_fee";
                  amount: number;
                  period: "campaign"
                  | "monthly"
                  | "quarterly"
                  | "annual";
                  currency: string;
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
              | {
                  pricing_option_id: string;
                  applies_to_output_format_ids?: {
                      agent_url: string;
                      id: string;
                      width?: (...)
                      | (...);
                      height?: (...) | (...);
                      duration_ms?: (...) | (...);
                  }[];
                  model: "per_unit";
                  unit: string;
                  unit_price: number;
                  currency: string;
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
              | {
                  pricing_option_id: string;
                  applies_to_output_format_ids?: {
                      agent_url: string;
                      id: string;
                      width?: (...)
                      | (...);
                      height?: (...) | (...);
                      duration_ms?: (...) | (...);
                  }[];
                  model: "custom";
                  description: string;
                  metadata: { summary_for_operator?: string };
                  currency?: string;
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
          )[];
      }[];
      pagination?: { has_more: boolean; cursor?: string; total_count?: number };
      ext?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
  }

  • Optionalcontext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalgovernance_context?: string

    Governance context token issued by the account's governance agent during check_governance. Buyers attach it to governed purchase requests (media buys, rights acquisitions, signal activations, creative services); sellers persist it and include it on all subsequent governance calls for that action's lifecycle. An account binds to one governance agent (see sync_governance); governance is phased across purchase / modification / delivery, not partitioned across specialist agents, so the envelope carries a single token for the full lifecycle.

    Value format: governance agents MUST emit a compact JWS per the AdCP JWS profile (see Security — Signed Governance Context). Sellers MAY verify; sellers that do not verify MUST persist and forward the token unchanged. In 3.1 all sellers MUST verify. Non-JWS values from pre-3.0 governance agents are deprecated.

    This is the primary correlation key for audit and reporting across the governance lifecycle.

  • lists: {
        list_id: string;
        name: string;
        description?: string;
        account?:
            | { account_id: string }
            | {
                brand: {
                    domain: string;
                    brand_id?: string;
                    industries?: string[];
                    data_subject_contestation?: {
                        url?: string;
                        email?: string;
                        languages?: string[];
                    };
                    brand_kit_override?: {
                        logo?: {
                            asset_type: "image";
                            url: string;
                            width: number;
                            height: number;
                            format?: (...)
                            | (...);
                            alt_text?: (...) | (...);
                            provenance?: (...) | (...);
                        };
                        colors?: {
                            primary?: (...)
                            | (...);
                            secondary?: (...) | (...);
                            accent?: (...) | (...);
                        };
                        voice?: string;
                        tagline?: string;
                    };
                };
                operator: string;
                sandbox?: boolean;
            };
        base_properties?: (
            | {
                selection_type: "publisher_tags";
                publisher_domain: string;
                tags: string[];
            }
            | {
                selection_type: "publisher_ids";
                publisher_domain: string;
                property_ids: string[];
            }
            | {
                selection_type: "identifiers";
                identifiers: { type: PropertyIdentifierTypes; value: string }[];
            }
        )[];
        filters?: {
            countries_all?: string[];
            channels_any?: MediaChannel[];
            property_types?: PropertyType[];
            feature_requirements?: {
                feature_id: string;
                min_value?: number;
                max_value?: number;
                allowed_values?: unknown[];
                if_not_covered?: "include"
                | "exclude";
                policy_id?: string;
            }[];
            exclude_identifiers?: { type: PropertyIdentifierTypes; value: string }[];
        };
        brand?: {
            domain: string;
            brand_id?: string;
            industries?: string[];
            data_subject_contestation?: {
                url?: string;
                email?: string;
                languages?: string[];
            };
            brand_kit_override?: {
                logo?: {
                    asset_type: "image";
                    url: string;
                    width: number;
                    height: number;
                    format?: string;
                    alt_text?: string;
                    provenance?: {
                        digital_source_type?: ...;
                        ai_tool?: ...;
                        human_oversight?: ...;
                        declared_by?: ...;
                        declared_at?: ...;
                        created_time?: ...;
                        c2pa?: ...;
                        embedded_provenance?: ...;
                        watermarks?: ...;
                        disclosure?: ...;
                        verification?: ...;
                        ext?: ...;
                    };
                };
                colors?: { primary?: string; secondary?: string; accent?: string };
                voice?: string;
                tagline?: string;
            };
        };
        webhook_url?: string;
        cache_duration_hours?: number;
        created_at?: string;
        updated_at?: string;
        property_count?: number;
        pricing_options?: (
            | {
                pricing_option_id: string;
                applies_to_output_format_ids?: {
                    agent_url: string;
                    id: string;
                    width?: (...)
                    | (...);
                    height?: (...) | (...);
                    duration_ms?: (...) | (...);
                }[];
                model: "cpm";
                cpm: number;
                currency: string;
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
            | {
                pricing_option_id: string;
                applies_to_output_format_ids?: {
                    agent_url: string;
                    id: string;
                    width?: (...)
                    | (...);
                    height?: (...) | (...);
                    duration_ms?: (...) | (...);
                }[];
                model: "percent_of_media";
                percent: number;
                max_cpm?: number;
                currency: string;
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
            | {
                pricing_option_id: string;
                applies_to_output_format_ids?: {
                    agent_url: string;
                    id: string;
                    width?: (...)
                    | (...);
                    height?: (...) | (...);
                    duration_ms?: (...) | (...);
                }[];
                model: "flat_fee";
                amount: number;
                period: "campaign"
                | "monthly"
                | "quarterly"
                | "annual";
                currency: string;
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
            | {
                pricing_option_id: string;
                applies_to_output_format_ids?: {
                    agent_url: string;
                    id: string;
                    width?: (...)
                    | (...);
                    height?: (...) | (...);
                    duration_ms?: (...) | (...);
                }[];
                model: "per_unit";
                unit: string;
                unit_price: number;
                currency: string;
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
            | {
                pricing_option_id: string;
                applies_to_output_format_ids?: {
                    agent_url: string;
                    id: string;
                    width?: (...)
                    | (...);
                    height?: (...) | (...);
                    duration_ms?: (...) | (...);
                }[];
                model: "custom";
                description: string;
                metadata: { summary_for_operator?: string };
                currency?: string;
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
        )[];
    }[]

    Array of property lists (metadata only, not resolved properties)

  • Optionalpagination?: { has_more: boolean; cursor?: string; total_count?: number }

    • has_more: boolean

      Whether more results are available beyond this page

    • Optionalcursor?: string

      Opaque cursor to pass in the next request to fetch the next page. Only present when has_more is true.

    • Optionaltotal_count?: number

      Total number of items matching the query across all pages. Optional because not all backends can efficiently compute this.

      Minimum

      0

  • Optionalext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

• Optionalsummary: string