Function creativeDeliveryResponse

Parameters

• data: {
      context?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
      governance_context?: string;
      account_id?: string;
      media_buy_id?: string;
      currency: string;
      reporting_period: { start: string; end: string; timezone?: string };
      creatives: {
          creative_id: string;
          media_buy_id?: string;
          format_id?: {
              agent_url: string;
              id: string;
              width?: number;
              height?: number;
              duration_ms?: number;
          };
          totals?: {
              impressions?: number;
              spend?: number;
              clicks?: number;
              ctr?: number;
              views?: number;
              completed_views?: number;
              completion_rate?: number;
              conversions?: number;
              conversion_value?: number;
              roas?: number;
              cost_per_acquisition?: number;
              new_to_brand_rate?: number;
              leads?: number;
              incremental_sales_lift?: number;
              brand_lift?: number;
              foot_traffic?: number;
              conversion_lift?: number;
              brand_search_lift?: number;
              plays?: number;
              by_event_type?: {
                  event_type: EventType;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              grps?: number;
              reach?: number;
              reach_unit?: ReachUnit;
              reach_window?: {
                  kind: "cumulative"
                  | "period"
                  | "rolling";
                  period?: {
                      interval: number;
                      unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
                  };
              };
              frequency?: number;
              quartile_data?: {
                  q1_views?: number;
                  q2_views?: number;
                  q3_views?: number;
                  q4_views?: number;
              };
              dooh_metrics?: {
                  loop_plays?: number;
                  screens_used?: number;
                  screen_time_seconds?: number;
                  sov_achieved?: number;
                  calculation_notes?: string;
                  venue_breakdown?: {
                      venue_id: string;
                      venue_name?: (...)
                      | (...);
                      venue_type?: (...) | (...);
                      impressions: number;
                      loop_plays?: (...) | (...);
                      screens_used?: (...) | (...);
                  }[];
              };
              viewability?: {
                  vendor?: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  measurable_impressions?: number;
                  viewable_impressions?: number;
                  viewable_rate?: number;
                  viewed_seconds?: number;
                  standard?: ViewabilityStandard;
              };
              engagements?: number;
              follows?: number;
              saves?: number;
              profile_visits?: number;
              engagement_rate?: number;
              cost_per_click?: number;
              cost_per_completed_view?: number;
              cpm?: number;
              downloads?: number;
              units_sold?: number;
              new_to_brand_units?: number;
              by_action_source?: {
                  action_source: ActionSource;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              vendor_metric_values?: {
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  metric_id: string;
                  value: number;
                  unit?: string;
                  measurable_impressions?: number;
                  breakdown?: Omit<(...), (...)> & { authentication?: ... };
              }[];
          };
          variant_count?: number;
          variants: {
              impressions?: number;
              spend?: number;
              clicks?: number;
              ctr?: number;
              views?: number;
              completed_views?: number;
              completion_rate?: number;
              conversions?: number;
              conversion_value?: number;
              roas?: number;
              cost_per_acquisition?: number;
              new_to_brand_rate?: number;
              leads?: number;
              incremental_sales_lift?: number;
              brand_lift?: number;
              foot_traffic?: number;
              conversion_lift?: number;
              brand_search_lift?: number;
              plays?: number;
              by_event_type?: {
                  event_type: EventType;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              grps?: number;
              reach?: number;
              reach_unit?: ReachUnit;
              reach_window?: {
                  kind: "cumulative"
                  | "period"
                  | "rolling";
                  period?: {
                      interval: number;
                      unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
                  };
              };
              frequency?: number;
              quartile_data?: {
                  q1_views?: number;
                  q2_views?: number;
                  q3_views?: number;
                  q4_views?: number;
              };
              dooh_metrics?: {
                  loop_plays?: number;
                  screens_used?: number;
                  screen_time_seconds?: number;
                  sov_achieved?: number;
                  calculation_notes?: string;
                  venue_breakdown?: {
                      venue_id: string;
                      venue_name?: (...)
                      | (...);
                      venue_type?: (...) | (...);
                      impressions: number;
                      loop_plays?: (...) | (...);
                      screens_used?: (...) | (...);
                  }[];
              };
              viewability?: {
                  vendor?: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  measurable_impressions?: number;
                  viewable_impressions?: number;
                  viewable_rate?: number;
                  viewed_seconds?: number;
                  standard?: ViewabilityStandard;
              };
              engagements?: number;
              follows?: number;
              saves?: number;
              profile_visits?: number;
              engagement_rate?: number;
              cost_per_click?: number;
              cost_per_completed_view?: number;
              cpm?: number;
              downloads?: number;
              units_sold?: number;
              new_to_brand_units?: number;
              by_action_source?: {
                  action_source: ActionSource;
                  event_source_id?: string;
                  count: number;
                  value?: number;
              }[];
              vendor_metric_values?: {
                  vendor: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  metric_id: string;
                  value: number;
                  unit?: string;
                  measurable_impressions?: number;
                  breakdown?: Omit<(...), (...)> & { authentication?: ... };
              }[];
              variant_id: string;
              manifest?: | {
                  format_id: {
                      agent_url: string;
                      id: string;
                      width?: number;
                      height?: number;
                      duration_ms?: number;
                  };
                  format_kind?: CanonicalFormatKind;
                  format_option_ref?: | {
                      scope: "publisher";
                      publisher_domain: string;
                      format_option_id: string;
                  }
                  | {
                      scope: "product";
                      format_option_id: string;
                      publisher_domain?: undefined;
                  };
                  assets: Omit<Omit<{ [key: ...]: ... }, "bank">, "authentication"> & {
                      authentication?: unknown;
                  };
                  brand?: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  rights?: {
                      rights_id: string;
                      rights_agent: { url: ...; id: ... };
                      valid_from?: (...) | (...);
                      valid_until?: (...) | (...);
                      uses: (...)[];
                      countries?: (...) | (...);
                      excluded_countries?: (...) | (...);
                      impression_cap?: (...) | (...);
                      right_type?: (...) | (...);
                      approval_status?: (...) | (...) | (...) | (...);
                      verification_url?: (...) | (...);
                      ext?: (...) | (...);
                  }[];
                  industry_identifiers?: { type: CreativeIdentifierType; value: string }[];
                  provenance?: {
                      digital_source_type?: DigitalSourceType;
                      ai_tool?: { name: ...; version?: ...; provider?: ... };
                      human_oversight?:
                          | "none"
                          | "prompt_only"
                          | "selected"
                          | "edited"
                          | "directed";
                      declared_by?: { agent_url?: ...; role: ... };
                      declared_at?: string;
                      created_time?: string;
                      c2pa?: { manifest_url: ... };
                      embedded_provenance?: (...)[];
                      watermarks?: (...)[];
                      disclosure?: { required: ...; jurisdictions?: ... };
                      verification?: (...)[];
                      ext?: (...) & (...);
                  };
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              }
              | {
                  format_id?: {
                      agent_url: string;
                      id: string;
                      width?: number;
                      height?: number;
                      duration_ms?: number;
                  };
                  format_kind: | "image"
                  | "custom"
                  | "html5"
                  | "display_tag"
                  | "image_carousel"
                  | "video_hosted"
                  | "video_vast"
                  | "audio_hosted"
                  | "audio_daast"
                  | "sponsored_placement"
                  | "native_in_feed"
                  | "responsive_creative"
                  | "agent_placement";
                  format_option_ref?: | {
                      scope: "publisher";
                      publisher_domain: string;
                      format_option_id: string;
                  }
                  | {
                      scope: "product";
                      format_option_id: string;
                      publisher_domain?: undefined;
                  };
                  assets: Omit<Omit<{ [key: ...]: ... }, "bank">, "authentication"> & {
                      authentication?: unknown;
                  };
                  brand?: {
                      domain: string;
                      brand_id?: string;
                      industries?: (...)[];
                      data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                      brand_kit_override?: {
                          logo?: ...;
                          colors?: ...;
                          voice?: ...;
                          tagline?: ...;
                      };
                  };
                  rights?: {
                      rights_id: string;
                      rights_agent: { url: ...; id: ... };
                      valid_from?: (...) | (...);
                      valid_until?: (...) | (...);
                      uses: (...)[];
                      countries?: (...) | (...);
                      excluded_countries?: (...) | (...);
                      impression_cap?: (...) | (...);
                      right_type?: (...) | (...);
                      approval_status?: (...) | (...) | (...) | (...);
                      verification_url?: (...) | (...);
                      ext?: (...) | (...);
                  }[];
                  industry_identifiers?: { type: CreativeIdentifierType; value: string }[];
                  provenance?: {
                      digital_source_type?: DigitalSourceType;
                      ai_tool?: { name: ...; version?: ...; provider?: ... };
                      human_oversight?:
                          | "none"
                          | "prompt_only"
                          | "selected"
                          | "edited"
                          | "directed";
                      declared_by?: { agent_url?: ...; role: ... };
                      declared_at?: string;
                      created_time?: string;
                      c2pa?: { manifest_url: ... };
                      embedded_provenance?: (...)[];
                      watermarks?: (...)[];
                      disclosure?: { required: ...; jurisdictions?: ... };
                      verification?: (...)[];
                      ext?: (...) & (...);
                  };
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              };
              generation_context?: {
                  context_type?: string;
                  artifact?: {
                      property_id: { type: PropertyIdentifierTypes; value: string };
                      artifact_id: string;
                  };
                  ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                      authentication?: unknown;
                  };
              };
          }[];
      }[];
      pagination?: {
          limit: number;
          offset: number;
          has_more: boolean;
          total_count?: number;
          total?: number;
      };
      errors?: {
          code: string;
          message: string;
          field?: string;
          suggestion?: string;
          retry_after?: number;
          issues?: {
              pointer: string;
              message: string;
              keyword: string;
              schemaPath?: string;
              schema_id?: string;
              discriminator?: {
                  property_name: string;
                  value: (...)
                  | (...)
                  | (...)
                  | (...)
                  | (...);
              }[];
          }[];
          details?: Omit<Omit<{}, "bank">, "authentication"> & {
              authentication?: unknown;
          };
          recovery?: "transient"
          | "correctable"
          | "terminal";
          source?: "producer" | "sdk";
          sdk_id?: string;
      }[];
      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.

  • Optionalaccount_id?: string

    Account identifier. Present when the response spans or is scoped to a specific account.

  • Optionalmedia_buy_id?: string

    Publisher's media buy identifier. Present when the request was scoped to a single media buy.

  • currency: string

    ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR')

    Pattern

    ^[A-Z]{3}$

  • reporting_period: { start: string; end: string; timezone?: string }

    Date range for the report.

    • start: string

      ISO 8601 start timestamp

      Format

      date-time

    • end: string

      ISO 8601 end timestamp

      Format

      date-time

    • Optionaltimezone?: string

      IANA timezone identifier for the reporting period (e.g., 'America/New_York', 'UTC'). Platforms report in their native timezone.

  • creatives: {
        creative_id: string;
        media_buy_id?: string;
        format_id?: {
            agent_url: string;
            id: string;
            width?: number;
            height?: number;
            duration_ms?: number;
        };
        totals?: {
            impressions?: number;
            spend?: number;
            clicks?: number;
            ctr?: number;
            views?: number;
            completed_views?: number;
            completion_rate?: number;
            conversions?: number;
            conversion_value?: number;
            roas?: number;
            cost_per_acquisition?: number;
            new_to_brand_rate?: number;
            leads?: number;
            incremental_sales_lift?: number;
            brand_lift?: number;
            foot_traffic?: number;
            conversion_lift?: number;
            brand_search_lift?: number;
            plays?: number;
            by_event_type?: {
                event_type: EventType;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            grps?: number;
            reach?: number;
            reach_unit?: ReachUnit;
            reach_window?: {
                kind: "cumulative"
                | "period"
                | "rolling";
                period?: {
                    interval: number;
                    unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
                };
            };
            frequency?: number;
            quartile_data?: {
                q1_views?: number;
                q2_views?: number;
                q3_views?: number;
                q4_views?: number;
            };
            dooh_metrics?: {
                loop_plays?: number;
                screens_used?: number;
                screen_time_seconds?: number;
                sov_achieved?: number;
                calculation_notes?: string;
                venue_breakdown?: {
                    venue_id: string;
                    venue_name?: (...)
                    | (...);
                    venue_type?: (...) | (...);
                    impressions: number;
                    loop_plays?: (...) | (...);
                    screens_used?: (...) | (...);
                }[];
            };
            viewability?: {
                vendor?: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                measurable_impressions?: number;
                viewable_impressions?: number;
                viewable_rate?: number;
                viewed_seconds?: number;
                standard?: ViewabilityStandard;
            };
            engagements?: number;
            follows?: number;
            saves?: number;
            profile_visits?: number;
            engagement_rate?: number;
            cost_per_click?: number;
            cost_per_completed_view?: number;
            cpm?: number;
            downloads?: number;
            units_sold?: number;
            new_to_brand_units?: number;
            by_action_source?: {
                action_source: ActionSource;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            vendor_metric_values?: {
                vendor: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                metric_id: string;
                value: number;
                unit?: string;
                measurable_impressions?: number;
                breakdown?: Omit<(...), (...)> & { authentication?: ... };
            }[];
        };
        variant_count?: number;
        variants: {
            impressions?: number;
            spend?: number;
            clicks?: number;
            ctr?: number;
            views?: number;
            completed_views?: number;
            completion_rate?: number;
            conversions?: number;
            conversion_value?: number;
            roas?: number;
            cost_per_acquisition?: number;
            new_to_brand_rate?: number;
            leads?: number;
            incremental_sales_lift?: number;
            brand_lift?: number;
            foot_traffic?: number;
            conversion_lift?: number;
            brand_search_lift?: number;
            plays?: number;
            by_event_type?: {
                event_type: EventType;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            grps?: number;
            reach?: number;
            reach_unit?: ReachUnit;
            reach_window?: {
                kind: "cumulative"
                | "period"
                | "rolling";
                period?: {
                    interval: number;
                    unit: "seconds" | "minutes" | "hours" | "days" | "campaign";
                };
            };
            frequency?: number;
            quartile_data?: {
                q1_views?: number;
                q2_views?: number;
                q3_views?: number;
                q4_views?: number;
            };
            dooh_metrics?: {
                loop_plays?: number;
                screens_used?: number;
                screen_time_seconds?: number;
                sov_achieved?: number;
                calculation_notes?: string;
                venue_breakdown?: {
                    venue_id: string;
                    venue_name?: (...)
                    | (...);
                    venue_type?: (...) | (...);
                    impressions: number;
                    loop_plays?: (...) | (...);
                    screens_used?: (...) | (...);
                }[];
            };
            viewability?: {
                vendor?: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                measurable_impressions?: number;
                viewable_impressions?: number;
                viewable_rate?: number;
                viewed_seconds?: number;
                standard?: ViewabilityStandard;
            };
            engagements?: number;
            follows?: number;
            saves?: number;
            profile_visits?: number;
            engagement_rate?: number;
            cost_per_click?: number;
            cost_per_completed_view?: number;
            cpm?: number;
            downloads?: number;
            units_sold?: number;
            new_to_brand_units?: number;
            by_action_source?: {
                action_source: ActionSource;
                event_source_id?: string;
                count: number;
                value?: number;
            }[];
            vendor_metric_values?: {
                vendor: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                metric_id: string;
                value: number;
                unit?: string;
                measurable_impressions?: number;
                breakdown?: Omit<(...), (...)> & { authentication?: ... };
            }[];
            variant_id: string;
            manifest?: | {
                format_id: {
                    agent_url: string;
                    id: string;
                    width?: number;
                    height?: number;
                    duration_ms?: number;
                };
                format_kind?: CanonicalFormatKind;
                format_option_ref?: | {
                    scope: "publisher";
                    publisher_domain: string;
                    format_option_id: string;
                }
                | {
                    scope: "product";
                    format_option_id: string;
                    publisher_domain?: undefined;
                };
                assets: Omit<Omit<{ [key: ...]: ... }, "bank">, "authentication"> & {
                    authentication?: unknown;
                };
                brand?: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                rights?: {
                    rights_id: string;
                    rights_agent: { url: ...; id: ... };
                    valid_from?: (...) | (...);
                    valid_until?: (...) | (...);
                    uses: (...)[];
                    countries?: (...) | (...);
                    excluded_countries?: (...) | (...);
                    impression_cap?: (...) | (...);
                    right_type?: (...) | (...);
                    approval_status?: (...) | (...) | (...) | (...);
                    verification_url?: (...) | (...);
                    ext?: (...) | (...);
                }[];
                industry_identifiers?: { type: CreativeIdentifierType; value: string }[];
                provenance?: {
                    digital_source_type?: DigitalSourceType;
                    ai_tool?: { name: ...; version?: ...; provider?: ... };
                    human_oversight?:
                        | "none"
                        | "prompt_only"
                        | "selected"
                        | "edited"
                        | "directed";
                    declared_by?: { agent_url?: ...; role: ... };
                    declared_at?: string;
                    created_time?: string;
                    c2pa?: { manifest_url: ... };
                    embedded_provenance?: (...)[];
                    watermarks?: (...)[];
                    disclosure?: { required: ...; jurisdictions?: ... };
                    verification?: (...)[];
                    ext?: (...) & (...);
                };
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            }
            | {
                format_id?: {
                    agent_url: string;
                    id: string;
                    width?: number;
                    height?: number;
                    duration_ms?: number;
                };
                format_kind: | "image"
                | "custom"
                | "html5"
                | "display_tag"
                | "image_carousel"
                | "video_hosted"
                | "video_vast"
                | "audio_hosted"
                | "audio_daast"
                | "sponsored_placement"
                | "native_in_feed"
                | "responsive_creative"
                | "agent_placement";
                format_option_ref?: | {
                    scope: "publisher";
                    publisher_domain: string;
                    format_option_id: string;
                }
                | {
                    scope: "product";
                    format_option_id: string;
                    publisher_domain?: undefined;
                };
                assets: Omit<Omit<{ [key: ...]: ... }, "bank">, "authentication"> & {
                    authentication?: unknown;
                };
                brand?: {
                    domain: string;
                    brand_id?: string;
                    industries?: (...)[];
                    data_subject_contestation?: { url?: ...; email?: ...; languages?: ... };
                    brand_kit_override?: {
                        logo?: ...;
                        colors?: ...;
                        voice?: ...;
                        tagline?: ...;
                    };
                };
                rights?: {
                    rights_id: string;
                    rights_agent: { url: ...; id: ... };
                    valid_from?: (...) | (...);
                    valid_until?: (...) | (...);
                    uses: (...)[];
                    countries?: (...) | (...);
                    excluded_countries?: (...) | (...);
                    impression_cap?: (...) | (...);
                    right_type?: (...) | (...);
                    approval_status?: (...) | (...) | (...) | (...);
                    verification_url?: (...) | (...);
                    ext?: (...) | (...);
                }[];
                industry_identifiers?: { type: CreativeIdentifierType; value: string }[];
                provenance?: {
                    digital_source_type?: DigitalSourceType;
                    ai_tool?: { name: ...; version?: ...; provider?: ... };
                    human_oversight?:
                        | "none"
                        | "prompt_only"
                        | "selected"
                        | "edited"
                        | "directed";
                    declared_by?: { agent_url?: ...; role: ... };
                    declared_at?: string;
                    created_time?: string;
                    c2pa?: { manifest_url: ... };
                    embedded_provenance?: (...)[];
                    watermarks?: (...)[];
                    disclosure?: { required: ...; jurisdictions?: ... };
                    verification?: (...)[];
                    ext?: (...) & (...);
                };
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            };
            generation_context?: {
                context_type?: string;
                artifact?: {
                    property_id: { type: PropertyIdentifierTypes; value: string };
                    artifact_id: string;
                };
                ext?: Omit<Omit<(...), (...)>, "authentication"> & {
                    authentication?: unknown;
                };
            };
        }[];
    }[]

    Creative delivery data with variant breakdowns

  • Optionalpagination?: {
        limit: number;
        offset: number;
        has_more: boolean;
        total_count?: number;
        total?: number;
    }

    Pagination information. Present when the request included pagination parameters. Note: get_creative_delivery uses page-based pagination (limit/offset) for historical reasons, distinct from the cursor-based PaginationResponse used by list_* tools. Field naming aligned with PaginationResponse.total_count in 3.1; the legacy total field is retained as a deprecated alias until 4.0. Sellers MUST populate both fields identically; buyers SHOULD prefer total_count (the canonical name) and ignore total if both are present.

    • limit: number

      Maximum number of creatives requested

      Minimum

      1

    • offset: number

      Number of creatives skipped

      Minimum

      0

    • has_more: boolean

      Whether more creatives are available beyond this page

    • Optionaltotal_count?: number

      Total number of creatives matching the request filters. Canonical field name (matches PaginationResponse.total_count). Sellers SHOULD populate this and the deprecated total field identically until 4.0; buyers SHOULD prefer this field.

      Minimum

      0

    • Optionaltotal?: number

      Deprecated

      Deprecated — use total_count instead. Retained as a legacy alias for 3.x backward compatibility; removed in AdCP 4.0. Sellers populating this field MUST also populate total_count with the same value.

      Minimum

      0

  • Optionalerrors?: {
        code: string;
        message: string;
        field?: string;
        suggestion?: string;
        retry_after?: number;
        issues?: {
            pointer: string;
            message: string;
            keyword: string;
            schemaPath?: string;
            schema_id?: string;
            discriminator?: {
                property_name: string;
                value: (...) | (...) | (...) | (...) | (...);
            }[];
        }[];
        details?: Omit<Omit<{}, "bank">, "authentication"> & {
            authentication?: unknown;
        };
        recovery?: "transient"
        | "correctable"
        | "terminal";
        source?: "producer" | "sdk";
        sdk_id?: string;
    }[]

    Task-specific errors and warnings

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

• Optionalsummary: string