---
title: "GET /v1/stats/{scope}"
method: GET
path: "/v1/stats/{scope}"
tags: ["Analytics"]
---

# GET /v1/stats/{scope}

`GET /v1/stats/{scope}`

Retrieves statistics.

## Path parameters

- `scope` 'line_item' | 'daily_by_line_item' | 'daily' | 'daily_by_conversion', required

## Query parameters

- `cursor` string
- `brand_id` string
- `client_id` string
- `campaign_id` string
- `line_item_id` string
- `line_item_lineage_id` string
- `start_date` string
- `end_date` string

## Response `200`

Successful Response

- object — Successful Response
  - `metadata` object
    - `cursor` unknown
    - `page_size` integer
    - `total` integer
  - `data` object[]
    - `line_item_id` string — Present for all scopes.<br>Identifies a single line item.
    - `line_item_lineage_id` string — Identifies a single line item across revisions.
    - `delivery_source_id` string — Present for daily and daily_by_conversion scopes.<br>Identifies a single delivery source.
    - `creative_id` unknown
    - `external_ad_ref` unknown
    - `conversion_id` string — Present for daily_by_conversion scope.<br>Identifies a single conversion.
    - `delivered_date` string — Present for daily_by_line_item and daily_by_conversion scopes.<br>The date the delivery took place.
    - `actual_start_date` string — Present for line_item scope.<br>First day Basis received delivery greater than zero for any delivery metric within the contracted flight range.
    - `data_through_date` string — Present for line_item scope.<br>Date stamp of the last day of delivery.
    - `delivery_metrics` object — Present for line_item, daily_by_line_item, and daily scopes.
      - `delivered_units` number — Impressions, clicks, views, or actions delivered. The definition of a unit depends on the line item's chosen rate type.
      - `delivered_impressions` number, required — Impressions delivered, rounded to a whole number.
      - `delivered_impressions_raw` number, required — Impressions delivered, including partial impressions.
      - `delivered_clicks` number, required — Clicks recorded.
      - `delivered_eligible_impressions` number, required — Impressions delivered against which Basis can measure viewability.
      - `delivered_measurable_impressions` number, required — Impressions delivered where our viewability provider's script was able to determine if they were viewable or not.
      - `delivered_viewable_impressions` number, required — Delivered impressions that our viewability provider's script was able to deem viewable.
      - `delivered_interactions` number, required — Delivered impressions that were expanded or engaged.
      - `delivered_video_starts` number, required — The number of times a video creative was started.
      - `delivered_video_completions` number, required — Video impressions that completed (reached the fourth quartile marker).
      - `delivered_total_view_conversions` number, required — View-through conversions, recorded after a user saw an ad from the campaign but did not click through.
      - `delivered_total_click_conversions` number, required — Click-through conversions, recorded after a user clicked an ad in the line item.
      - `delivered_total_conversions` number, required — All click-through and view-through conversions added together.
      - `delivered_cpa_view_conversions` number, required — Cost per action for view-through conversions.
      - `delivered_cpa_click_conversions` number, required — Cost per action for click-through conversions.
      - `delivered_cpa_total_conversions` number, required — Cost per action for total conversions (click-through and view-through combined).
      - `delivered_inventory_spend` number — Dollar amount spent on media inventory only.
      - `delivered_data_spend` number — Dollar amount spent on data services used to serve media inventory.
      - `total_spend` number — Present for line_item and daily_by_line_item scopes.<br>Comprehensive amount of purchases based on billable delivery.
      - `media_spend` number — Present for line_item and daily_by_line_item scopes.<br>Dollar amount spent on media.
      - `ad_serving_spend` number — Present for line_item and daily_by_line_item scopes.<br>In Basis, Ad Serving is a specified ad server rate and calculated cost.
      - `auctions_won` number — Number of exchange auctions won.
    - `performance_metrics` object — Present for line_item scope.
      - `ecpm` number, required — Effective cost per mille (CPM), the average cost per 1000 impressions.
      - `ecpc` number, required — Effective cost per click.
      - `ecpcv` number, required — Effective cost per completed view (applies to video only).
      - `ecpv` number, required — Effective cost per view (applies to video only).
      - `ecpvi` number, required — Effective cost per viewable impression.
      - `ecpa` number, required — Effective cost per acquisition.
      - `click_through_rate` number, required — Click-through rate (CTR).
      - `to_kpi_goal_pct` number — Percentage to track the progress of the KPI Goal.
      - `pacing_pct_spend` number, required — Pacing on-schedule indicator, expressed as a percentage of the expected or desired spend to date.
      - `pacing_pct_units` number, required — Pacing on-schedule indicator, expressed as a percentage of the expected or desired units delivered to date.
      - `projected_balance` number, required — The balance projected if the line item continues delivering at the current pace.
      - `total_unspent` number, required — The amount budgeted that hasn't been spent.
      - `delivery_spend_pct` number, required — The percent of the budgeted gross that has been spent on delivery.
      - `target_spend` number — The amount budgeted to be spent by this line item.
      - `target_units` number — The number of units to be delivered by this line item.
    - `conversion_metrics` object — Present for daily_by_conversion scope.
      - `click_conversions` number, required — Count of click-through conversions
      - `click_conversion_revenue` number, required — Total revenue associated with click-through conversions
      - `view_conversions` number, required — Count of view-through conversions
      - `view_conversion_revenue` number, required — Total revenue associated with view-through conversions
      - `total_conversions` number, required — Total conversion count
      - `total_conversion_revenue` number, required — Total conversion revenue

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/basis/apis/basis-platform-api.md) · [All operations](https://skmtc.net/basis/apis/basis-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basis/basis-platform-api/revisions/6e0eb87d51e6/schema)