List Winback Opportunities
Get paginated list of winback opportunities with filtering
Related endpoints
GET /analytics/revenue/mrr-summary— MRR SummaryGET /analytics/revenue/time-series— Revenue Time SeriesGET /analytics/invoices/ar-aging— A/R Aging ReportGET /analytics/collections/dso— Days Sales OutstandingGET /analytics/customers/ltv— Customer LTVGET /analytics/customers/{customerId}— Customer AnalyticsGET /analytics/payment-links/conversion— Payment Link ConversionGET /analytics/checkout/funnel— Checkout Funnel Analytics
Pagination
Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.
x-api-key<token>
Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.
In: header
Query Parameters
type?string
Filter by opportunity type
Value in
"cancelled_subscription" | "repeat_abandoner" | "lapsed_customer"status?string
Filter by status
Value in
"identified" | "contacted" | "converted" | "declined" | "expired"minValueCents?|
Minimum potential value in cents
Range
0 <= valuepage?integer
Page number
Default
1Range
1 <= valuepageSize?integer
Results per page (1-100)
Default
20Range
1 <= value <= 100Response Body
application/json
curl "https://api.revkeen.com/v2/analytics/checkout/winback" \
-H "x-api-key: $REVKEEN_API_KEY"{
"opportunities": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
"customer_email": "string",
"opportunity_type": "cancelled_subscription",
"status": "identified",
"potential_value_cents": 0,
"currency": "string",
"previous_purchases_cents": 0,
"cancel_reason": "string",
"last_activity_at": "string",
"winback_emails_sent": 0,
"special_offer_code": "string",
"special_offer_discount": 0,
"created_at": "string",
"expires_at": "string"
}
],
"total": 0,
"page": 0,
"page_size": 0
}