> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Aggregated Reporting Data

Returns aggregated reporting data across all brand connections. The response includes a summary of totals, a daily performance breakdown, and a table of rows grouped by the requested columns. Only the `advertiser` filter is supported for narrowing results.


## OpenAPI

````yaml openapi/marketplace-reporting.yaml post /partners/reporting/entity
openapi: 3.0.3
info:
  title: Everflow Marketplace API - Reporting
  description: >
    Reporting endpoints for the Everflow Marketplace API. Retrieve aggregated
    reporting data across all brand connections.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Reporting
    description: Marketplace reporting endpoints.
paths:
  /partners/reporting/entity:
    post:
      tags:
        - Reporting
      summary: Get Aggregated Reporting Data
      requestBody:
        required: true
        content:
          application/json:
            example:
              from: '2026-03-01'
              to: '2026-04-01'
              timezone_id: 85
              currency_id: USD
              columns:
                - column: advertiser
                - column: offer
              query:
                filters:
                  - resource_type: advertiser
                    filter_id_value: '3539'
            schema:
              type: object
              required:
                - from
                - to
                - timezone_id
                - currency_id
                - columns
              properties:
                from:
                  type: string
                  description: 'Start date (format: YYYY-MM-DD).'
                to:
                  type: string
                  description: 'End date (format: YYYY-MM-DD).'
                timezone_id:
                  type: integer
                  description: >
                    Timezone ID for the report. Can be found using the [metadata
                    API](/api-reference/get-metatimezones).
                currency_id:
                  type: string
                  description: Currency code for reporting metrics (e.g. USD).
                columns:
                  type: array
                  description: >
                    Columns to group/pivot data by. At least one column must be
                    specified.
                  items:
                    type: object
                    required:
                      - column
                    properties:
                      column:
                        type: string
                        enum:
                          - advertiser
                          - offer
                        description: The dimension to group by.
                query:
                  type: object
                  description: Optional query filters.
                  properties:
                    filters:
                      type: array
                      description: >
                        Filters to narrow the report scope. Only advertiser
                        filters are supported.
                      items:
                        type: object
                        properties:
                          resource_type:
                            type: string
                            enum:
                              - advertiser
                            description: The resource type to filter on.
                          filter_id_value:
                            type: string
                            description: The ID value to filter by.
      responses:
        '200':
          description: >-
            Aggregated reporting data, daily performance breakdown, and grouped
            table data for the requested columns and filters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  summary:
                    type: object
                    description: Aggregated totals across all matching data.
                    properties:
                      imp:
                        type: integer
                        description: Total impressions.
                      total_click:
                        type: integer
                        description: Total clicks.
                      unique_click:
                        type: integer
                        description: Unique clicks.
                      invalid_click:
                        type: integer
                        description: Invalid clicks.
                      duplicate_click:
                        type: integer
                        description: Duplicate clicks.
                      ctr:
                        type: number
                        description: Click-through rate.
                      cv:
                        type: integer
                        description: Total conversions.
                      view_through_cv:
                        type: integer
                        description: View-through conversions.
                      event:
                        type: integer
                        description: Total events.
                      cvr:
                        type: number
                        description: Conversion rate.
                      evr:
                        type: number
                        description: Event rate.
                      rpc:
                        type: number
                        description: Revenue per click.
                      rpm:
                        type: number
                        description: Revenue per mille (thousand impressions).
                      revenue:
                        type: number
                        description: Total revenue.
                      redirect_traffic_revenue:
                        type: number
                        description: Revenue from redirect traffic.
                      referral_revenue:
                        type: number
                        description: Revenue from referrals.
                  performance:
                    type: array
                    description: >
                      Daily performance breakdown. Each entry represents one day
                      within the requested date range.
                    items:
                      type: object
                      properties:
                        unix:
                          type: integer
                          description: Unix timestamp for the start of this day.
                        reporting:
                          type: object
                          description: Reporting metrics for this day.
                          properties:
                            imp:
                              type: integer
                              description: Impressions for the day.
                            total_click:
                              type: integer
                              description: Total clicks for the day.
                            unique_click:
                              type: integer
                              description: Unique clicks for the day.
                            invalid_click:
                              type: integer
                              description: Invalid clicks for the day.
                            duplicate_click:
                              type: integer
                              description: Duplicate clicks for the day.
                            ctr:
                              type: number
                              description: Click-through rate for the day.
                            cv:
                              type: integer
                              description: Conversions for the day.
                            view_through_cv:
                              type: integer
                              description: View-through conversions for the day.
                            event:
                              type: integer
                              description: Events for the day.
                            cvr:
                              type: number
                              description: Conversion rate for the day.
                            evr:
                              type: number
                              description: Event rate for the day.
                            rpc:
                              type: number
                              description: Revenue per click for the day.
                            rpm:
                              type: number
                              description: >-
                                Revenue per mille (thousand impressions) for the
                                day.
                            revenue:
                              type: number
                              description: Revenue for the day.
                            redirect_traffic_revenue:
                              type: number
                              description: Revenue from redirect traffic for the day.
                            referral_revenue:
                              type: number
                              description: Revenue from referrals for the day.
                  table:
                    type: object
                    description: >-
                      Grouped reporting data broken down by the requested
                      columns.
                    properties:
                      rows:
                        type: array
                        items:
                          type: object
                          properties:
                            columns:
                              type: array
                              description: The dimension values for this row.
                              items:
                                type: object
                                properties:
                                  column_type:
                                    type: string
                                    description: >-
                                      The column dimension (e.g. advertiser,
                                      offer).
                                  id:
                                    type: string
                                    description: The ID of the entity.
                                  label:
                                    type: string
                                    description: The display name of the entity.
                            reporting:
                              type: object
                              description: Reporting metrics for this row.
                              properties:
                                imp:
                                  type: integer
                                  description: Impressions for this row.
                                total_click:
                                  type: integer
                                  description: Total clicks for this row.
                                unique_click:
                                  type: integer
                                  description: Unique clicks for this row.
                                invalid_click:
                                  type: integer
                                  description: Invalid clicks for this row.
                                duplicate_click:
                                  type: integer
                                  description: Duplicate clicks for this row.
                                ctr:
                                  type: number
                                  description: Click-through rate for this row.
                                cv:
                                  type: integer
                                  description: Conversions for this row.
                                view_through_cv:
                                  type: integer
                                  description: View-through conversions for this row.
                                event:
                                  type: integer
                                  description: Events for this row.
                                cvr:
                                  type: number
                                  description: Conversion rate for this row.
                                evr:
                                  type: number
                                  description: Event rate for this row.
                                rpc:
                                  type: number
                                  description: Revenue per click for this row.
                                rpm:
                                  type: number
                                  description: >-
                                    Revenue per mille (thousand impressions) for
                                    this row.
                                revenue:
                                  type: number
                                  description: Revenue for this row.
                                redirect_traffic_revenue:
                                  type: number
                                  description: Revenue from redirect traffic for this row.
                                referral_revenue:
                                  type: number
                                  description: Revenue from referrals for this row.
                  incomplete_results:
                    type: boolean
                    description: Whether the result set was truncated due to row limits.
                  has_all_impression_packages:
                    type: boolean
                    description: >-
                      Whether all impression packages are included in the
                      results.
      security:
        - API Key: []
components:
  securitySchemes:
    API Key:
      description: >-
        The Marketplace API key found in My Account > API on
        partners.everflow.io.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````