Incomaker Reporting v1
API Reference
API Reference
  1. Conversions
  • Incomaker Reporting v1
  • Abandoned carts
    • Get abandoned carts list
      GET
    • Get abandoned carts detail
      GET
  • Campaigns
    • Get campaigns count and metrics by language
      GET
    • Get campaign assets
      GET
    • Get campaigns list
      GET
    • Get campaigns daily results
      GET
    • Get campaigns monthly summanry
      GET
    • Get campaigns results hourly histogram
      GET
    • Get campaigns results daily histogram
      GET
    • Get campaigns results monthly histogram
      GET
    • Get list of senders
      GET
    • Get list of contacts timeline for campaign
      GET
    • Get list of contacts for campaign
      GET
    • Get list of contacts for period
      GET
    • Get A/B tests for campaigns
      GET
    • Get campaign conversions
      GET
    • Get campaign recipient list
      GET
    • Get campaign recipient activity timeline
      GET
    • Get campaign link click stats
      GET
  • Conversions
    • Get individual conversions (source-agnostic)
      GET
    • Get conversions list
      GET
    • Get total conversions
      GET
    • Get conversions by timeframe
      GET
    • Get daily conversions
      GET
  • Contacts
    • Get contacts
      GET
    • Get contacts details
      GET
    • Get contacts recommendation
      GET
    • Get unsubscribed contacts
      GET
    • Get duplicate contacts
      GET
    • Get contacts with invalid names
      GET
    • Get contact gender statistics
      GET
  • Segments
    • Get segments list
  • Deliveries
    • Get sends list
    • Get deliveries overview
    • Get deliveries list
    • Get delivery conversions
    • Get delivery-specific conversions
    • Get delivery recipient activity
    • Get recipient activity timeline
    • Get delivery link click stats
    • Get delivery detail
    • Get deliveries count and metrics by language
    • Get deliveries daily results
    • Get delivery daily detail for individual smartflow
  • RFM Analysis
    • Get Recency × Frequency heatmap
    • Get Recency × Monetary heatmap
    • Get Frequency × Monetary heatmap
    • Get full RFM cube or slices
    • Get recency distribution
    • Get frequency distribution
    • Get monetary distribution
    • Get combined RFM distributions
    • Get cell table
    • Get cell detail
    • Get contacts in cell
    • Get contact RFM detail
    • Get RFM Segments
    • Get RFM outliers
    • Get review candidates
  • Dialogs
    • Get dialogs list
    • Get dialogs data
  • Orders
    • Get orders list
    • Get order detail
    • Get order recommendation
  • Products
    • Get products
    • Get individual purchases for a product
    • Get products frequently purchased together
    • Get product categories
    • Get product detail
    • Get products by campaign
    • Get products by revenues
    • Get products recommendation
  • Schemas
    • Paging
    • ConversionAggregate
    • Contact
  1. Conversions

Get total conversions

GET
/conversions/totals
Aggregated conversions data for the selected period. conversions is always an array, regardless of any query parameter -- this is the standard "aggregate query, optional grouping" shape (SQL/pandas groupby, Google Analytics' Reporting API). With no interval, the array holds exactly one row, the grand total for the whole window. With interval, one row per bucket. There is exactly one response contract for this endpoint, never a plain case and a grouped case with different shapes.
Every interval (including its absence) shares the same eligibility filters and per-conversion-day FX pricing as /conversions and /conversions/daily: a conversion counts if it has non-zero net revenue (refunds reported separately in refundsNumber/refundsAmount*, never netted in), is attributed via a click within 30 days (last-click, 30-day window), and its order is not a best-effort-detected cancellation. Every amount is priced at that conversion's own day's FX rate -- an hour-of-day or weekday bucket spans many calendar dates, so it is still priced day-by-day internally and summed, not priced once for the whole bucket.

Request

Query Params

Header Params

Responses

🟢200
application/json
OK
Bodyapplication/json

🟠403
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/conversions/totals?dateFrom=2026-01-01&dateTo=2026-01-31&country=CZ%2CSK&currency=EUR%2CCZK&interval=day' \
--header 'Authorization: Bearer JWT'
Response Response Example
200 - No interval -- grand total (one row)
The standard "aggregate query" case: an array with exactly one item.
{
    "conversions": [
        {
            "conversionsAmountWoTax": 92668421.55,
            "conversionsAmountWTax": 111803752.35,
            "conversionsNumber": 79076,
            "currency": "CZK",
            "averageConversion": 1414.0,
            "uniqueContacts": 55223,
            "averageUniqueConversion": 2024.6,
            "refundsAmountWoTax": 812004.11,
            "refundsAmountWTax": 975604.93,
            "refundsNumber": 612,
            "grossConversionsAmountWoTax": 93480425.66,
            "grossConversionsAmountWTax": 112779357.28,
            "grossConversionsNumber": 79688,
            "breakdown": [
                {
                    "currency": "CZK",
                    "conversionsAmountWoTax": 64659785.92,
                    "conversionsAmountWTax": 78230752,
                    "conversionsNumber": 47914,
                    "averageConversion": 1632.73,
                    "refundsAmountWoTax": 500000,
                    "refundsAmountWTax": 605000,
                    "refundsNumber": 380,
                    "grossConversionsAmountWoTax": 65159785.92,
                    "grossConversionsAmountWTax": 78835752,
                    "grossConversionsNumber": 48294,
                    "conversionAmountWoTaxReference": 64659785.92,
                    "conversionAmountWTaxReference": 78230752
                },
                {
                    "currency": "EUR",
                    "conversionsAmountWoTax": 1282625.24,
                    "conversionsAmountWTax": 1560959.95,
                    "conversionsNumber": 20701,
                    "averageConversion": 75.41,
                    "refundsAmountWoTax": 9500,
                    "refundsAmountWTax": 11495,
                    "refundsNumber": 150,
                    "grossConversionsAmountWoTax": 1292125.24,
                    "grossConversionsAmountWTax": 1572454.95,
                    "grossConversionsNumber": 20851,
                    "conversionAmountWoTaxReference": 31968151.48,
                    "conversionAmountWTaxReference": 38905365.79
                }
            ]
        }
    ]
}
Modified at 2026-09-19 15:57:01
Previous
Get conversions list
Next
Get conversions by timeframe
Built with