Get conversions list

GET

/conversions

One row per attributing source (campaign, automation, or smartflow node) with aggregated conversions data for the selected period.

Every conversion-reporting endpoint (/conversions*, /campaigns*, /deliveries*) now shares one definition and one FX rule: a conversion counts if it has non-zero net revenue (refunds are reported separately, never netted into the main amount), it is attributed to a campaign via a click touch within 30 days of the conversion (last-click, 30-day window), and its order is not a best-effort-detected cancellation. Every amount is converted to the plugin's reference currency at that conversion's own day's exchange rate -- not the campaign's send date, not "today". Because of this, non-smartflow /conversions volume equals /campaigns volume exactly for the same window.

q matches both the row name and the owning smartflow's name.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location '/conversions?dateFrom=2026-01-01&dateTo=2026-01-31&country=CZ%2CSK&currency=EUR%2CCZK&limit=100&offset=0&q=Alpha&sort=-conversionsAmountWTax%2Cname' \
--header 'Authorization: Bearer JWT'

Response Example

200 - Success (campaign row)

{
    "conversions": [
        {
            "id": "11ed6a77-93c1-1330-bf67-c7acfbf36741",
            "name": "AUTO_Vratkový formulář - 48 hodin dopravy zdarma",
            "source": {
                "type": "automation",
                "id": "11ed6a77-93c1-1330-bf67-c7acfbf36741",
                "name": "AUTO_Vratkový formulář - 48 hodin dopravy zdarma",
                "campaignId": "11ed6a77-93c1-1330-bf67-c7acfbf36741",
                "smartflowId": null,
                "smartflowName": null,
                "deliveryId": null,
                "deliveryName": null,
                "detailUrl": "/v1/campaigns/11ed6a77-93c1-1330-bf67-c7acfbf36741/conversions"
            },
            "sourceStartedAt": "2026-01-21T07:17:51.000Z",
            "firstConversionAt": "2026-01-21T09:02:11.000Z",
            "lastConversionAt": "2026-01-31T22:47:03.000Z",
            "conversionsAmountWoTax": 1205826.9,
            "conversionsAmountWTax": 1452553.28,
            "conversionsNumber": 1321,
            "referenceCurrency": "CZK",
            "uniqueContacts": 2171,
            "averageConversion": 1099.59,
            "averageUniqueConversion": 669.07,
            "refundsAmountWoTax": 12500,
            "refundsAmountWTax": 15125,
            "refundsNumber": 4,
            "grossConversionsAmountWoTax": 1218326.9,
            "grossConversionsAmountWTax": 1467678.28,
            "grossConversionsNumber": 1325,
            "breakdown": [
                {
                    "currency": "CZK",
                    "conversionsAmountWoTax": 638588.07,
                    "conversionsAmountWTax": 772667,
                    "conversionsNumber": 785,
                    "averageConversion": 984.29,
                    "refundsAmountWoTax": 8000,
                    "refundsAmountWTax": 9680,
                    "refundsNumber": 3,
                    "grossConversionsAmountWoTax": 646588.07,
                    "grossConversionsAmountWTax": 782347,
                    "grossConversionsNumber": 788,
                    "conversionAmountWoTaxReference": 638588.07,
                    "conversionAmountWTaxReference": 772667
                },
                {
                    "currency": "EUR",
                    "conversionsAmountWoTax": 18257.68,
                    "conversionsAmountWTax": 21921.2,
                    "conversionsNumber": 400,
                    "averageConversion": 54.8,
                    "refundsAmountWoTax": 180,
                    "refundsAmountWTax": 218,
                    "refundsNumber": 1,
                    "grossConversionsAmountWoTax": 18437.68,
                    "grossConversionsAmountWTax": 22139.2,
                    "grossConversionsNumber": 401,
                    "conversionAmountWoTaxReference": 455054.42,
                    "conversionAmountWTaxReference": 546363.99
                }
            ]
        }
    ],
    "paging": {
        "start": 1,
        "count": 1,
        "totalCount": 12
    }
}

Modified at 2026-09-18 17:09:02

Get individual conversions (source-agnostic)

Get total conversions