For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling โ€” append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Analyze cancellations with cancellation flow sessions reports

Generate a new cancellation flow sessions report to see why customers cancel, what they told you, and whether your Cancellation Flows salvaged their subscription.

Product area

  • Reporting
  • Subscriptions

Tooling

  • API
  • Retain

Released

November 9, 2026

Status

Released

API version

Version 1

What's new?

We've added a new cancellation flow sessions report to the Paddle platform. It lists each session, once it ends, where a customer went through one of your Cancellation Flows, so you can see why customers cancel and how well your flows salvage subscriptions.

How it works

Reports in Paddle let you export information from your account to import into accounting software, ERPs, and other business intelligence tools.

The new cancellation flow sessions report includes the cancellation reason, satisfaction insight, and feedback each customer gave. It records the salvage attempt and discount offer the customers saw, what they decided, and whether the session was salvaged, failed to salvage, or was abandoned. Each row also includes the cancellation flow, the customer, and the products and prices on the subscription when the customer started the session.

You can generate it whenever you need it from the Paddle dashboard or the Paddle API, for any date range.

You can filter cancellation flow sessions reports by:

  • cancellation_flow_session_created_at: the date range when sessions were created. If you don't pass a gte filter, the report includes sessions created in the month before the report was generated.
  • cancellation_flow_id: one or more cancellation flows.
  • cancellation_flow_session_resolution: whether sessions were salvaged, failed_to_salvage, or abandoned.

Example

This example creates a cancellation flow sessions report for sessions created in November 2026 where the customer went on to cancel:

POST/reports
Request
{
"type": "cancellation_flow_sessions",
"filters": [
{
"name": "cancellation_flow_session_resolution",
"value": ["failed_to_salvage"]
},
{
"name": "cancellation_flow_session_created_at",
"operator": "gte",
"value": "2026-11-01T00:00:00Z"
},
{
"name": "cancellation_flow_session_created_at",
"operator": "lt",
"value": "2026-12-01T00:00:00Z"
}
]
}
Response (201 Created)
{
"data": {
"id": "rep_01jz9k3w5m8qt2vx7bnc4rhd6y",
"type": "cancellation_flow_sessions",
"rows": null,
"status": "pending",
"filters": [
{
"name": "cancellation_flow_session_resolution",
"value": ["failed_to_salvage"],
"operator": null
},
{
"name": "cancellation_flow_session_created_at",
"value": "2026-11-01T00:00:00Z",
"operator": "gte"
},
{
"name": "cancellation_flow_session_created_at",
"value": "2026-12-01T00:00:00Z",
"operator": "lt"
}
],
"expires_at": null,
"created_at": "2026-12-01T09:12:44.301Z",
"updated_at": "2026-12-01T09:12:44.301Z"
},
"meta": {
"request_id": "8e4b1f27-3c6a-4d95-a0b2-7f13c9e5d861"
}
}

Next steps

The cancellation flow sessions report is available now in version 1 of the Paddle API and in the Paddle dashboard. You don't need to do anything to get this change.

If we've let you know that your cancellation flow is moving from ProfitWell to Paddle Billing, the report will automatically be enabled on your account over the next few weeks.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check out the cancellation flow sessions report guide and the report entity overview in the API reference to get started.

Summary of changes

Report

Resource
  • + AddedEnum valuetype

    cancellation_flow_sessions added.

Reports

Feature
  • + AddedFieldcancellation_flow_session_created_at

    Filter cancellation flow sessions reports by the date a session was created.

  • + AddedFieldcancellation_flow_id

    Filter cancellation flow sessions reports by cancellation flow.

  • + AddedFieldcancellation_flow_session_resolution

    Filter cancellation flow sessions reports by how a session ended.

Was this page helpful?