Interface GetSignalsResponse

Optionalrestricted_attributes?: RestrictedAttribute[]

Optionaldemographic_predicate?: DemographicPredicate

Optionalpolicy_categories?: string[]

Optionaltaxonomy?: {
    ref: string;
    version?: string;
    segtax?: number;
    etag?: string;
    values: { id: string; path?: string; modifiers?: string[] }[];
    value_mappings?: {
        value: string;
        taxonomy_value_id: string;
        path?: string;
        modifiers?: string[];
    }[];
    parent_match_behavior?: "unknown"
    | "exact_only"
    | "descendants_supported";
}

Optionalsegmentation_criteria?: string

Optionalcriteria_url?: string

Optionaldata_sources?: (
    | "email"
    | "app_behavior"
    | "app_usage"
    | "web_usage"
    | "geo_location"
    | "tv_ott_or_stb_device"
    | "panel"
    | "online_ecommerce"
    | "credit_data"
    | "loyalty_card"
    | "transaction"
    | "online_survey"
    | "offline_survey"
    | "public_record_census"
    | "public_record_voter_file"
    | "public_record_other"
    | "offline_transaction"
)[]

Optionalmethodology?: "declared" | "inferred" | "modeled" | "observed" | "derived"

Optionalaudience_expansion?: boolean

Optionaldevice_expansion?: boolean

Optionalrefresh_cadence?:
    | "daily"
    | "weekly"
    | "monthly"
    | "quarterly"
    | "intra_day"
    | "bi_monthly"
    | "bi_annually"
    | "annually"

Optionallookback_window?:
    | "daily"
    | "weekly"
    | "monthly"
    | "quarterly"
    | "intra_day"
    | "bi_monthly"
    | "bi_annually"
    | "annually"

Optionalonboarder?: {
    match_keys: (
        | "email"
        | "name"
        | "address"
        | "postal"
        | "lat_long"
        | "mobile_id"
        | "cookie_id"
        | "ip"
        | "customer_id"
        | "phone"
    )[];
    pre_onboarding_audience_expansion?: boolean;
    pre_onboarding_device_expansion?: boolean;
    pre_onboarding_precision_level?: | "individual"
    | "household"
    | "business"
    | "geography";
}

Optionalcountries?: string[]

Optionalconsent_basis?: ConsentBasis[]

Optionalart9_basis?:
    | "explicit_consent"
    | "manifestly_made_public"
    | "substantial_public_interest"
    | "vital_interests"

Optionalmodeling?: {
    method: "lookalike" | "supervised" | "embedding" | "rules";
    seed_source: {
        type:
            | "panel"
            | "first_party_crm"
            | "declared_survey"
            | "transactional"
            | "behavioral";
        provider_signed: boolean;
    };
    training_data_jurisdictions: string[];
    ai_act_risk_class: "limited"
    | "minimal"
    | "high_risk";
    disclosure?: {
        required: boolean;
        jurisdictions?: [
            {
                country: string;
                region?: (...)
                | (...);
                regulation: string;
                disclosure_text?: (...) | (...);
                disclosure_url?: (...) | (...);
                audience?: (...) | (...) | (...) | (...) | (...);
            },
            ...{
                country: string;
                region?: (...)
                | (...);
                regulation: string;
                disclosure_text?: (...) | (...);
                disclosure_url?: (...) | (...);
                audience?: (...) | (...) | (...) | (...) | (...);
            }[],
        ];
        notes?: string;
    };
}

• method: "lookalike" | "supervised" | "embedding" | "rules"

• seed_source: {
      type:
          | "panel"
          | "first_party_crm"
          | "declared_survey"
          | "transactional"
          | "behavioral";
      provider_signed: boolean;
  }

  • type: "panel" | "first_party_crm" | "declared_survey" | "transactional" | "behavioral"

  • provider_signed: boolean

    Provider assertion that the seed source carries a signed attestation. Consumers MUST NOT treat this boolean alone as cryptographic proof.

• training_data_jurisdictions: string[]

• ai_act_risk_class: "limited" | "minimal" | "high_risk"

• Optionaldisclosure?: {
      required: boolean;
      jurisdictions?: [
          {
              country: string;
              region?: (...)
              | (...);
              regulation: string;
              disclosure_text?: (...) | (...);
              disclosure_url?: (...) | (...);
              audience?: (...) | (...) | (...) | (...) | (...);
          },
          ...{
              country: string;
              region?: (...)
              | (...);
              regulation: string;
              disclosure_text?: (...) | (...);
              disclosure_url?: (...) | (...);
              audience?: (...) | (...) | (...) | (...) | (...);
          }[],
      ];
      notes?: string;
  }

  • required: boolean

    The provider's claim that a modeling or AI-use disclosure is required for this signal in at least one applicable jurisdiction. This is a declared compliance signal, not a protocol-level legal determination.

  • Optionaljurisdictions?: [
        {
            country: string;
            region?: (...)
            | (...);
            regulation: string;
            disclosure_text?: (...) | (...);
            disclosure_url?: (...) | (...);
            audience?: (...) | (...) | (...) | (...) | (...);
        },
        ...{
            country: string;
            region?: (...)
            | (...);
            regulation: string;
            disclosure_text?: (...) | (...);
            disclosure_url?: (...) | (...);
            audience?: (...) | (...) | (...) | (...) | (...);
        }[],
    ]

    Jurisdictions where a modeling or AI-use disclosure applies.

    Min Items

    1

  • Optionalnotes?: string

    Optional provider notes on how the disclosure should be interpreted. Informational only; buyers should not branch programmatically on this text.

Optionaldata_subject_rights?: {
    upstream_source_domain?: string;
    channels: {
        rights: (
            "access"
            | "rectification"
            | "erasure"
            | "portability"
            | "objection"
        )[];
        url?: string;
        email?: string;
        languages?: string[];
        countries?: string[];
    }[];
    response_sla_days?: number;
    ccpa_opt_out_url?: string;
}

Optionallast_updated?: string

Optionaldts_compliant_version?: string

Optionalsignal_ref?: SignalRef

Optionalsignal_id?: SignalID

name: string

description: string

Optionalmethodology_url?: string

Optionalvalue_type?: SignalValueType

Optionalcategories?: string[]

Optionalrange?: { min: number; max: number }

• min: number

  Minimum value (inclusive)

• max: number

  Maximum value (inclusive)

signal_agent_segment_id: string

signal_type: SignalAvailabilityType

Optionaldata_provider?: string

Optionalcoverage_percentage?: number

Optionalcoverage_forecast?: {
    points: [
        ForecastPoint & { dimensions: {}; metrics?: {} },
        ...(ForecastPoint & { dimensions: {}; metrics?: {} })[],
    ];
    forecast_range_unit: "availability";
    method: ForecastMethod;
    scope: {
        kind: "product" | "inventory" | "custom" | "account";
        label: string;
        product_id?: string;
        countries?: [string, ...string[]];
        line_item_types?: [string, ...string[]];
        date_range?: DateRange;
    };
    bucket_semantics: "exclusive"
    | "overlapping";
    bucket_completeness: "complete" | "partial";
    generated_at?: string;
    valid_until?: string;
    ext?: ExtensionObject;
}

• points: [
      ForecastPoint & { dimensions: {}; metrics?: {} },
      ...(ForecastPoint & { dimensions: {}; metrics?: {} })[],
  ]

  Coverage or availability points. Each point reuses the standard ForecastPoint shape, MUST include a signal dimension, and MUST include metrics.coverage_rate. Use metrics.impressions for count denominators and metrics.coverage_rate for the fraction of the declared scope represented by the point.

  Min Items

  1

• forecast_range_unit: "availability"

  How to interpret the points array. Signal coverage forecasts always use 'availability' because the points describe available inventory or population coverage, not spend curves or temporal pacing.

• method: ForecastMethod

• scope: {
      kind: "product" | "inventory" | "custom" | "account";
      label: string;
      product_id?: string;
      countries?: [string, ...string[]];
      line_item_types?: [string, ...string[]];
      date_range?: DateRange;
  }

  Explicit denominator for the coverage forecast. This identifies the inventory, product, account, or custom universe that coverage_rate values are relative to. Additional seller-specific qualifiers are allowed for scopes such as line item type, ad server, inventory class, country, or flight window.

  • kind: "product" | "inventory" | "custom" | "account"

    Denominator family for the coverage forecast.

  • label: string

    Human-readable denominator label, such as 'network price-priority inventory'.

  • Optionalproduct_id?: string

    Product denominator when kind is 'product'.

  • Optionalcountries?: [string, ...string[]]

    Countries included in the denominator, as ISO 3166-1 alpha-2 codes.

    Min Items

    1

  • Optionalline_item_types?: [string, ...string[]]

    Seller or ad-server line item types included in the denominator.

    Min Items

    1

  • Optionaldate_range?: DateRange

• bucket_semantics: "exclusive" | "overlapping"

  'exclusive' means the returned signal-value buckets do not overlap with each other. 'overlapping' means one impression or user can appear in multiple returned buckets, so coverage_rate values may sum above 1.0. This field describes overlap among returned buckets; bucket_completeness declares whether the returned buckets cover the full denominator.

• bucket_completeness: "complete" | "partial"

  'complete' means the returned buckets cover the declared denominator. For complete + exclusive forecasts, count metrics and coverage_rate values can be treated as a full partition, subject to metric additivity rules. 'partial' means omitted denominator share represents undisclosed, other, or unsupported buckets; buyers MUST NOT infer totals by summing returned points.

• Optionalgenerated_at?: string

  When this coverage forecast was computed.

• Optionalvalid_until?: string

  When this coverage forecast expires.

• Optionalext?: ExtensionObject

deployments: Deployment[]

Optionalpricing_options?: VendorPricingOption[]

scope: "signals" | "pricing" | "wholesale_feed"

description: string

Optionalestimated_wait?: Duration