Skip to main content
POST
/
partners
/
reporting
/
entity
Get Aggregated Reporting Data
curl --request POST \
  --url https://api.eflow.team/v1/partners/reporting/entity \
  --header 'Content-Type: application/json' \
  --header 'X-Eflow-Api-Key: <api-key>' \
  --data '
{
  "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"
      }
    ]
  }
}
'
{
  "summary": {
    "imp": 123,
    "total_click": 123,
    "unique_click": 123,
    "invalid_click": 123,
    "duplicate_click": 123,
    "ctr": 123,
    "cv": 123,
    "view_through_cv": 123,
    "event": 123,
    "cvr": 123,
    "evr": 123,
    "rpc": 123,
    "rpm": 123,
    "revenue": 123,
    "redirect_traffic_revenue": 123,
    "referral_revenue": 123
  },
  "performance": [
    {
      "unix": 123,
      "reporting": {
        "imp": 123,
        "total_click": 123,
        "unique_click": 123,
        "invalid_click": 123,
        "duplicate_click": 123,
        "ctr": 123,
        "cv": 123,
        "view_through_cv": 123,
        "event": 123,
        "cvr": 123,
        "evr": 123,
        "rpc": 123,
        "rpm": 123,
        "revenue": 123,
        "redirect_traffic_revenue": 123,
        "referral_revenue": 123
      }
    }
  ],
  "table": {
    "rows": [
      {
        "columns": [
          {
            "column_type": "<string>",
            "id": "<string>",
            "label": "<string>"
          }
        ],
        "reporting": {
          "imp": 123,
          "total_click": 123,
          "unique_click": 123,
          "invalid_click": 123,
          "duplicate_click": 123,
          "ctr": 123,
          "cv": 123,
          "view_through_cv": 123,
          "event": 123,
          "cvr": 123,
          "evr": 123,
          "rpc": 123,
          "rpm": 123,
          "revenue": 123,
          "redirect_traffic_revenue": 123,
          "referral_revenue": 123
        }
      }
    ]
  },
  "incomplete_results": true,
  "has_all_impression_packages": true
}
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.

Authorizations

X-Eflow-Api-Key
string
header
required

The Marketplace API key found in My Account > API on partners.everflow.io.

Body

application/json
from
string
required

Start date (format: YYYY-MM-DD).

to
string
required

End date (format: YYYY-MM-DD).

timezone_id
integer
required

Timezone ID for the report. Can be found using the metadata API.

currency_id
string
required

Currency code for reporting metrics (e.g. USD).

columns
object[]
required

Columns to group/pivot data by. At least one column must be specified.

query
object

Optional query filters.

Response

200 - application/json
summary
object

Aggregated totals across all matching data.

performance
object[]

Daily performance breakdown. Each entry represents one day within the requested date range.

table
object

Grouped reporting data broken down by the requested columns.

incomplete_results
boolean

Whether the result set was truncated due to row limits.

has_all_impression_packages
boolean

Whether all impression packages are included in the results.