Conversions API

Base URL: https://qck.sh/public-api/v1

Conversions are ingested as journey events with event_type: "conversion". See Journey API for the ingestion endpoint. These endpoints query conversion data.

Permission: conversions:read

Common parameters

Param	Type	Default	Description
period	string	30d	24h, 7d, 30d, or 90d
domain_id	string	None	Filter to a custom domain
link_id	string	None	Filter to a specific link

---

Summary

GET /conversions/summary

{
  "success": true,
  "data": {
    "total_conversions": 340,
    "unique_converters": 280,
    "total_revenue": 16800.50,
    "average_order_value": 49.41,
    "conversion_rate": 4.2
  }
}

---

Timeseries

GET /conversions/timeseries

Additional parameter:

Param	Type	Default	Description
interval	string	day	hour, day, week, month

{
  "success": true,
  "data": [
    { "timestamp": "2026-04-01", "conversions": 12, "revenue": 590.00 },
    { "timestamp": "2026-04-02", "conversions": 18, "revenue": 880.50 }
  ]
}

---

Breakdown

GET /conversions/breakdown

Additional parameter:

Param	Type	Required	Description
dimension	string	Yes	device, country, link, or name

{
  "success": true,
  "data": [
    { "label": "United States", "conversions": 180, "revenue": 8900.00, "conversion_rate": 5.1 },
    { "label": "Germany", "conversions": 45, "revenue": 2200.00, "conversion_rate": 3.8 }
  ]
}

---

Time to convert

GET /conversions/time-to-convert

How long from first click to conversion.

{
  "success": true,
  "data": {
    "buckets": [
      { "label": "< 1 hour", "count": 85 },
      { "label": "1-24 hours", "count": 120 },
      { "label": "1-7 days", "count": 95 },
      { "label": "7+ days", "count": 40 }
    ],
    "average_seconds": 43200,
    "median_seconds": 28800
  }
}