---
title: "Get Daily Business Impact"
method: GET
path: "/api/commerce/impact/daily"
tags: ["commerce"]
---

# Get Daily Business Impact

`GET /api/commerce/impact/daily`

## Request

- Base URL: `https://api.advisorppc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.advisorppc.com/api/commerce/impact/daily`
- Auth: HTTP bearer

Return one source-backed UTC day.

Without ``day``, the response uses the last completed UTC day. An explicit
``day`` is returned unchanged.

## Query parameters

- `day` string, date, nullable
- `currency` string, nullable

## Headers

- `X-Tenant-Id` integer, nullable

## Response `200`

Successful Response

- DailyBusinessImpactOut
  - `day` string, date, required
  - `generated_at` string, date-time, required
  - `state` 'available' | 'partial' | 'unavailable', required
  - `impacts` DailyCurrencyImpactOut[], required
    - `currency` string, required
    - `currency_exponent` integer, required
    - `attributed_revenue` AttributedRevenueImpactOut, required
      - `state` 'available' | 'unavailable', required
      - `selection_state` 'bound' | 'unavailable', required
      - `aggregation_grain` 'selected_store_portfolio_utc_day' | 'unavailable', required
      - `additivity_state` 'proven' | 'unavailable', required
      - `additivity_proof` 'single_selected_store', nullable, required
      - `coverage_state` 'complete' | 'incomplete' | 'ambiguous' | 'unavailable', required
      - `expected_selection_count` integer, nullable
      - `observed_selection_count` integer, nullable
      - `headline_eligible` boolean, required
      - `amount_minor` integer, nullable, required
      - `confidence` 'high' | 'medium' | 'low' | 'unavailable', required
      - `basis` 'gross_order_value_attributed'
      - `formula` 'sum(attributed_revenue_minor)'
      - `exclusions` string[]
      - `provenance` ImpactProvenanceOut[], required
        - `source_system` string, required
        - `record_count` integer, required
        - `latest_source_observed_at` string, date-time, required
        - `latest_ingested_at` string, date-time, required
      - `freshness` ImpactFreshnessOut, required
        - `state` 'fresh' | 'stale' | 'unavailable', required
        - `as_of` string, date-time, nullable, required
        - `max_age_seconds` 86400
    - `verified_ad_savings` VerifiedAdSavingsImpactOut, required
      - `state` 'verified' | 'estimated' | 'unavailable', required
      - `selection_state` 'bound' | 'unavailable', required
      - `aggregation_grain` 'observed_verified_savings_partition_utc_day' | 'observed_estimated_savings_scope_utc_day' | 'unavailable', required
      - `additivity_state` 'proven' | 'unavailable', required
      - `additivity_proof` 'single_observed_verified_partition' | 'single_observed_estimated_scope', nullable, required
      - `coverage_state` 'complete' | 'unknown' | 'unavailable', required
      - `coverage_scope` 'selected_portfolio' | 'observed_subset' | 'unavailable', required
      - `headline_eligible` boolean, required
      - `direction` 'savings' | 'loss' | 'neutral' | 'unavailable', required
      - `amount_minor` integer, nullable, required
      - `estimated_amount_minor` integer, nullable, required
      - `confidence` 'high' | 'medium' | 'low' | 'unavailable', required
      - `basis` 'approved_applied_optimization_counterfactual' | 'connector_estimate', nullable, required
      - `formula` 'counterfactual_spend_minor - observed_spend_minor' | 'source_supplied_estimated_savings_minor', nullable, required
      - `exclusions` string[]
      - `provenance` ImpactProvenanceOut[], required
        - `source_system` string, required
        - `record_count` integer, required
        - `latest_source_observed_at` string, date-time, required
        - `latest_ingested_at` string, date-time, required
      - `freshness` ImpactFreshnessOut, required
        - `state` 'fresh' | 'stale' | 'unavailable', required
        - `as_of` string, date-time, nullable, required
        - `max_age_seconds` 86400
      - `estimated_confidence` 'high' | 'medium' | 'low' | 'unavailable', required
      - `estimated_provenance` ImpactProvenanceOut[], required
        - `source_system` string, required
        - `record_count` integer, required
        - `latest_source_observed_at` string, date-time, required
        - `latest_ingested_at` string, date-time, required
      - `estimated_freshness` ImpactFreshnessOut, required
        - `state` 'fresh' | 'stale' | 'unavailable', required
        - `as_of` string, date-time, nullable, required
        - `max_age_seconds` 86400
    - `ad_budget_burn` AdBudgetBurnImpactOut, required
      - `state` 'available' | 'unavailable', required
      - `selection_state` 'bound' | 'unavailable', required
      - `aggregation_grain` 'selected_provider_account_portfolio_utc_day' | 'unavailable', required
      - `additivity_state` 'proven' | 'unavailable', required
      - `additivity_proof` 'distinct_selected_provider_accounts', nullable, required
      - `coverage_state` 'complete' | 'incomplete' | 'ambiguous' | 'unavailable', required
      - `expected_selection_count` integer, nullable
      - `observed_selection_count` integer, nullable
      - `headline_eligible` boolean, required
      - `spent_minor` integer, nullable, required
      - `planned_budget_minor` integer, nullable, required
      - `utilization_bps` integer, nullable, required
      - `comparability_state` 'proven' | 'unavailable', required
      - `comparability_proof` 'same_tenant_provider_account_scope_utc_day_currency_exponent_planned_period', nullable, required
      - `confidence` 'high' | 'medium' | 'low' | 'unavailable', required
      - `basis` 'actual_ad_spend_observed'
      - `formula` 'sum(spent_minor); utilization_bps = round_half_up(spent_minor * 10000 / planned_budget_minor)'
      - `exclusions` string[]
      - `provenance` ImpactProvenanceOut[], required
        - `source_system` string, required
        - `record_count` integer, required
        - `latest_source_observed_at` string, date-time, required
        - `latest_ingested_at` string, date-time, required
      - `freshness` ImpactFreshnessOut, required
        - `state` 'fresh' | 'stale' | 'unavailable', required
        - `as_of` string, date-time, nullable, required
        - `max_age_seconds` 86400
  - `connector_action` 'connect' | 'reconnect', nullable
  - `connectors_url` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/advisorppc/apis/advisorppc-api.md) · [All operations](https://skmtc.dev/advisorppc/apis/advisorppc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/advisorppc/apis/advisorppc-api/revisions/3441bd729e0c?raw)