---
title: "Entity Reporting"
method: POST
path: "/advertisers/reporting/entity"
tags: ["Advertiser Reporting"]
---

# Entity Reporting

`POST /advertisers/reporting/entity`

## Request body

- object
  - `from` string, required — Start date for the reporting period. Format `YYYY-MM-DD`.
  - `to` string, required — End date for the reporting period. Format `YYYY-MM-DD`.
  - `timezone_id` integer, required — Timezone identifier for the request.
  - `currency_id` string, required — Currency code for monetary values (e.g. "USD").
  - `columns` object[], required — Columns to group/pivot data by. Minimum 1, maximum 10. Only one time column (hour, date, week, month, year) is allowed per request.
    - `column` 'offer' | 'affiliate' | 'creative' | 'offer_url' | 'country' | 'country_code' | 'region' | 'city' | 'dma' | 'carrier' | 'platform' | 'isp' | 'os_version' | 'device_type' | 'device_model' | 'device_make' | 'browser' | 'language' | 'sub1' | 'sub2' | 'sub3' | 'sub4' | 'sub5' | 'sub6' | 'sub7' | 'sub8' | 'sub9' | 'sub10' | 'source_id' | 'connection_type' | 'advertiser_campaign_name' | 'app_identifier' | 'bundle_id' | 'meta_platform' | 'score_rating' | 'total_rating' | 'size' | 'developer' | 'version' | 'hour' | 'date' | 'week' | 'month' | 'year', required — The dimension to group by. Time columns (hour, date, week, month, year) are mutually exclusive — only one allowed at a time.
  - `query` object — Query configuration for filtering, metric filtering, and exclusions.
    - `filters` object[] — Filters to narrow results. Same resource_type filters use OR logic; different resource_type filters use AND logic.
      - `filter_id_value` string, required — The value to filter on (e.g. offer ID, country name).
      - `resource_type` 'offer' | 'affiliate' | 'creative' | 'country' | 'country_code' | 'sub1' | 'sub2' | 'sub3' | 'sub4' | 'sub5' | 'sub6' | 'sub7' | 'sub8' | 'sub9' | 'sub10' | 'carrier' | 'device_platform' | 'device_type' | 'device_make' | 'browser' | 'language' | 'connection_type' | 'source_id' | 'offer_url' | 'device_model' | 'os_version' | 'coupon_code' | 'adv1' | 'adv2' | 'adv3' | 'adv4' | 'adv5' | 'adv6' | 'adv7' | 'adv8' | 'adv9' | 'adv10', required — The resource type / dimension to filter on.
    - `metric_filters` object[] — Filters rows based on aggregated metric thresholds (e.g. return only rows where cost > 0). Applied after aggregation, before the row limit.
      - `metric_type` 'impression' | 'total_click' | 'unique_click' | 'cv' | 'event' | 'revenue' | 'gross_sales' — The metric to filter on. Note: an advertiser's "cost" is the `revenue` metric — use `metric_type: revenue` to filter on cost.
      - `metric_value` number — Threshold value.
      - `operator` 'less_than' | 'less_than_or_equal' | 'greater_than' | 'greater_than_or_equal' — Comparison operator.
    - `exclusions` object[] — Exclusion filters to remove specific dimension values from results.
      - `filter_id_value` string — The value to exclude.
      - `resource_type` string — The resource type / dimension to exclude on.

## Response `200`

- object
  - `table` object[] — Array of reporting data rows grouped by the requested columns.
    - `columns` object[] — Dimension values for this row.
      - `column_type` string — The column/dimension type (matches the requested column value).
      - `id` string — Dimension value identifier (e.g. offer ID, country name).
      - `label` string — Human-readable label for the dimension value.
    - `reporting` ReportingMetrics — Aggregated performance metrics.
      - `imp` integer — Impression count.
      - `total_click` integer — Total click count.
      - `unique_click` integer — Unique click count.
      - `invalid_click` integer — Invalid/filtered click count.
      - `cv` integer — Conversion count.
      - `event` integer — Post-conversion event count.
      - `cvr` number — Conversion rate (percentage).
      - `evr` number — Event rate.
      - `ctr` number — Click-through rate (impressions to clicks).
      - `cost` number — Total cost (advertiser spend).
      - `cpc` number — Cost per click.
      - `cpm` number — Cost per mille (per 1,000 impressions).
      - `gross_sales` number — Total gross sales amount.
  - `performance` object[] — Time-series performance data points.
    - `unix` integer — Unix timestamp for the time period.
    - `reporting` ReportingMetrics — Aggregated performance metrics.
      - `imp` integer — Impression count.
      - `total_click` integer — Total click count.
      - `unique_click` integer — Unique click count.
      - `invalid_click` integer — Invalid/filtered click count.
      - `cv` integer — Conversion count.
      - `event` integer — Post-conversion event count.
      - `cvr` number — Conversion rate (percentage).
      - `evr` number — Event rate.
      - `ctr` number — Click-through rate (impressions to clicks).
      - `cost` number — Total cost (advertiser spend).
      - `cpc` number — Cost per click.
      - `cpm` number — Cost per mille (per 1,000 impressions).
      - `gross_sales` number — Total gross sales amount.
  - `summary` ReportingMetrics — Aggregated performance metrics.
    - `imp` integer — Impression count.
    - `total_click` integer — Total click count.
    - `unique_click` integer — Unique click count.
    - `invalid_click` integer — Invalid/filtered click count.
    - `cv` integer — Conversion count.
    - `event` integer — Post-conversion event count.
    - `cvr` number — Conversion rate (percentage).
    - `evr` number — Event rate.
    - `ctr` number — Click-through rate (impressions to clicks).
    - `cost` number — Total cost (advertiser spend).
    - `cpc` number — Cost per click.
    - `cpm` number — Cost per mille (per 1,000 impressions).
    - `gross_sales` number — Total gross sales amount.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)